toolchain/binutils/libiberty/fnmatch.txh

   1 @deftypefn Replacement int fnmatch (const char *@var{pattern}, const char *@var{string}, int @var{flags})
   2
   3 Matches @var{string} against @var{pattern}, returning zero if it
   4 matches, @code{FNM_NOMATCH} if not.  @var{pattern} may contain the
   5 wildcards @code{?} to match any one character, @code{*} to match any
   6 zero or more characters, or a set of alternate characters in square
   7 brackets, like @samp{[a-gt8]}, which match one character (@code{a}
   8 through @code{g}, or @code{t}, or @code{8}, in this example) if that one
   9 character is in the set.  A set may be inverted (i.e., match anything
  10 except what's in the set) by giving @code{^} or @code{!} as the first
  11 character in the set.  To include those characters in the set, list them
  12 as anything other than the first character of the set.  To include a
  13 dash in the set, list it last in the set.  A backslash character makes
  14 the following character not special, so for example you could match
  15 against a literal asterisk with @samp{\*}.  To match a literal
  16 backslash, use @samp{\\}.
  17
  18 @code{flags} controls various aspects of the matching process, and is a
  19 boolean OR of zero or more of the following values (defined in
  20 @code{<fnmatch.h>}):
  21
  22 @table @code
  23
  24 @item FNM_PATHNAME
  25 @itemx FNM_FILE_NAME
  26 @var{string} is assumed to be a path name.  No wildcard will ever match
  27 @code{/}.
  28
  29 @item FNM_NOESCAPE
  30 Do not interpret backslashes as quoting the following special character.
  31
  32 @item FNM_PERIOD
  33 A leading period (at the beginning of @var{string}, or if
  34 @code{FNM_PATHNAME} after a slash) is not matched by @code{*} or
  35 @code{?} but must be matched explicitly.
  36
  37 @item FNM_LEADING_DIR
  38 Means that @var{string} also matches @var{pattern} if some initial part
  39 of @var{string} matches, and is followed by @code{/} and zero or more
  40 characters.  For example, @samp{foo*} would match either @samp{foobar}
  41 or @samp{foobar/grill}.
  42
  43 @item FNM_CASEFOLD
  44 Ignores case when performing the comparison.
  45
  46 @end table
  47
  48 @end deftypefn