*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Linux man pages -> fnmatch (3)              
Title
Content
Arch
Section
 

FNMATCH(3)

Contents


NAME    [Toc]    [Back]

       fnmatch - match filename or pathname

SYNOPSIS    [Toc]    [Back]

       #include <fnmatch.h>

       int fnmatch(const char *pattern, const char *string, int flags);

DESCRIPTION    [Toc]    [Back]

       The  fnmatch()  function checks whether the string argument matches the
       pattern argument, which is a shell wildcard pattern.

       The flags argument modifies the behaviour; it is the bitwise OR of zero
       or more of the following flags:

       FNM_NOESCAPE    [Toc]    [Back]
	      If  this	flag is set, treat backslash as an ordinary character,
	      instead of an escape character.

       FNM_PATHNAME    [Toc]    [Back]
	      If this flag is set, match a slash in string only with  a  slash
	      in pattern and not, for example, with a [] - sequence containing
	      a slash.

       FNM_PERIOD    [Toc]    [Back]
	      If this flag is set, a  leading  period  in  string  has	to  be
	      matched  exactly by a period in pattern.	A period is considered
	      to be leading if it is the first character in string, or if both
	      FNM_PATHNAME  is set and the period immediately follows a slash.

       FNM_FILE_NAME    [Toc]    [Back]
	      This is a GNU synonym for FNM_PATHNAME.

       FNM_LEADING_DIR    [Toc]    [Back]
	      If this flag (a GNU extension) is set, the pattern is considered
	      to  be  matched if it matches an initial segment of string which
	      is followed by a slash.  This flag is mainly  for  the  internal
	      use of glibc and is only implemented in certain cases.

       FNM_CASEFOLD    [Toc]    [Back]
	      If  this	flag  (a GNU extension) is set, the pattern is matched
	      case-insensitively.

RETURN VALUE    [Toc]    [Back]

       Zero if string matches pattern, FNM_NOMATCH if there  is  no  match  or
       another non-zero value if there is an error.

CONFORMING TO    [Toc]    [Back]

       ISO/IEC	9945-2:  1993  (POSIX.2).  The FNM_FILE_NAME, FNM_LEADING_DIR,
       and FNM_CASEFOLD flags are GNU extensions.

SEE ALSO    [Toc]    [Back]

      
      
       sh(1), glob(3), glob(7)



GNU				  2000-10-15			    FNMATCH(3)
[ Back ]
 Similar pages
Name OS Title
fnmatch OpenBSD match filename or pathname using shell globbing rules
fnmatch NetBSD match filename or pathname using shell glob rules
fnmatch Tru64 Match filename patterns
basename OpenBSD return filename portion of pathname
basename FreeBSD return filename or directory portion of pathname
dirname FreeBSD return filename or directory portion of pathname
dirname_r Tru64 Return the base filename or directory portion of a pathname
dirname Tru64 Return the base filename or directory portion of a pathname
basename Tru64 Return the base filename or directory portion of a pathname
fnmatch FreeBSD test whether a filename or pathname matches a shell-style pattern
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service