fnmatch(3c) [hpux man page]

fnmatch(3C)															       fnmatch(3C)

NAME

       fnmatch() - match filename patterns

SYNOPSIS

DESCRIPTION

       performs  pattern  matching  as described in regexp(5) under By default, the rule qualifications for filename expansion do not apply; i.e.,
       periods (dots) and slashes are matched as ordinary characters.  This default behavior can be modified by using the flags described below.

       The flag argument modifies the interpretation of pattern and string.  If which is defined in is set in flag, a slash  character	in  string
       must  be  explicitly matched by a slash in pattern; it cannot be matched by either the asterisk or question mark special characters or by a
       bracket expression.

       If is set in flag, a leading period must be explicitly matched.	It will not be matched by a bracket expression, question mark or asterisk.
       By  default, a period is leading if it is the first character in string.  If is set in flag, a period is leading if it is the first charac-
       ter in string or immediately follows a slash.

       If is not set in flag, a backslash character in pattern followed by any other character matches that second character in string.   In  par-
       ticular, matches a backslash in string.	If is set, a backslash character is treated as an ordinary character.

       If  flag  is  zero, the slash character and the period are treated as regular characters.  If flag has any other value, the result is unde-
       fined.

RETURN VALUE

       If string matches the pattern specified by pattern, returns zero.  Otherwise, returns non-zero.

EXAMPLE

       The following excerpt uses to check each file in a directory against the pattern

	      pattern = "*.c";
	      while(dp = readdir(dirp)){
		  if((fnmatch(pattern, dp->d_name,0)) == 0){
		      /* do processing for match */
			    ...
		  }
	      }

AUTHOR

       was developed by OSF and HP.

SEE ALSO

       sh(1), glob(3C), thread_safety(5).

STANDARDS CONFORMANCE

																       fnmatch(3C)

FNMATCH(3)						     Linux Programmer's Manual							FNMATCH(3)

NAME

       fnmatch - match filename or pathname

SYNOPSIS

       #include <fnmatch.h>

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

DESCRIPTION

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

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

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

       FNM_PATHNAME
	      If  this	flag  is  set,	match  a  slash  in  string only with a slash in pattern and not by an asterisk (*) or a question mark (?)
	      metacharacter, nor by a bracket expression ([]) containing a slash.

       FNM_PERIOD
	      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
	      This is a GNU synonym for FNM_PATHNAME.

       FNM_LEADING_DIR
	      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
	      If this flag (a GNU extension) is set, the pattern is matched case-insensitively.

RETURN VALUE

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

CONFORMING TO

       POSIX.2.  The FNM_FILE_NAME, FNM_LEADING_DIR, and FNM_CASEFOLD flags are GNU extensions.

SEE ALSO

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

COLOPHON

       This page is part of release 3.27 of the Linux man-pages project.  A description of the project, and information about reporting bugs,  can
       be found at http://www.kernel.org/doc/man-pages/.

GNU
								    2000-10-15								FNMATCH(3)