FNMATCH
Section: C Library Functions (3)
Index
Return to Main Contents
BSD mandoc
NAME
fnmatch
- match filename or pathname
SYNOPSIS
Fd #include <fnmatch.h>
Ft int
Fn fnmatch const char *pattern const char *string int flags
DESCRIPTION
The
Fn fnmatch
function
matches patterns according to the rules used by the shell.
It checks the string specified by the
Fa string
argument to see if it matches the pattern specified by the
Fa pattern
argument.
The
Fa flags
argument modifies the interpretation of
Fa pattern
and
Fa string .
The value of
Fa flags
is the bitwise inclusive
OR
of any of the following
constants, which are defined in the include file
fnmatch.h
- FNM_NOESCAPE
-
Normally, every occurrence of a backslash
(`\'
)
followed by a character in
Fa pattern
is replaced by that character.
This is done to negate any special meaning for the character.
If the
FNM_NOESCAPE
flag is set, a backslash character is treated as an ordinary character.
- FNM_PATHNAME
-
Slash characters in
Fa string
must be explicitly matched by slashes in
Fa pattern .
If this flag is not set, then slashes are treated as regular characters.
- FNM_PERIOD
-
Leading periods in strings match periods in patterns.
The definition of ``leading'' is related to the specification of
FNM_PATHNAME.
A period is always ``leading'' if it is the first character in
string
Additionally, if
FNM_PATHNAME
is set,
a period is ``leading'' if it immediately follows a slash.
RETURN VALUES
The
Fn fnmatch
function returns zero if
Fa string
matches the pattern specified by
Fa pattern ,
otherwise, it returns the value
FNM_NOMATCH
SEE ALSO
sh(1),
glob(3),
regex(3)
STANDARDS
The
Fn fnmatch
function conforms to
St -p1003.2-92 .
HISTORY
The
Fn fnmatch
function first appeared in
BSD 4.4
BUGS
The pattern
`*'
matches the empty string, even if
FNM_PATHNAME
is specified.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUES
-
- SEE ALSO
-
- STANDARDS
-
- HISTORY
-
- BUGS
-
This document was created by
man2html,
using the manual pages.
Time: 15:52:54 GMT, January 15, 2023