| 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
|
|---|
