file::fnmatch(3pm) [debian man page]

FnMatch(3pm)						User Contributed Perl Documentation					      FnMatch(3pm)

NAME

       File::FnMatch - simple filename and pathname matching

SYNOPSIS

	 use File::FnMatch qw(:fnmatch);    # import everything

	 # shell-style: match "/a/bc", but not "/a/.bc" nor "/a/b/c"
	 fnmatch("/a/*", $fn, FNM_PATHNAME|FNM_PERIOD);

	 # find our A- executables only
	 grep { fnmatch("A-*.exe", $_) } readdir SOMEDIR;

DESCRIPTION

       File::FnMatch::fnmatch() provides simple, shell-like pattern matching.

       Though considerably less powerful than regular expressions, shell patterns are nonetheless useful and familiar to a large audience of end-
       users.

   Functions
       fnmatch ( PATTERN, STRING [, FLAGS] )
	   Returns true if PATTERN matches STRING, undef otherwise.  FLAGS may be the bitwise OR'ing of any supported FNM_* constants (see below).

   Constants
       FNM_NOESCAPE
	   Do not treat a backslash ('') in PATTERN specially.  Otherwise, a backslash escapes the following character.

       FNM_PATHNAME
	   Prohibit wildcards from matching a slash ('/').

       FNM_PERIOD
	   Prohibit wildcards from matching a period ('.') at the start of a string and, if FNM_PATHNAME is also given, immediately after a slash.

       Other possibilities include at least FNM_CASEFOLD (compare "qr//i"), FNM_LEADING_DIR to restrict matching to everything before the first
       '/', FNM_FILE_NAME as a synonym for FNM_PATHNAME, and the rather more exotic FNM_EXTMATCH.  Consult your system documentation for details.

   EXPORT
       None by default.  The export tag ":fnmatch" exports the fnmatch function and all available FNM_* constants.

PATTERN SYNTAX

       Wildcards are the question mark ('?') to match any single character and the asterisk ('*') to match zero or more characters.  FNM_PATHNAME
       and FNM_PERIOD restrict the scope of the wildcards, notably supporting the UNIX convention of concealing "dotfiles":

       Bracket expressions, enclosed by '[' and ']', match any of a set of characters specified explicitly ("[abcdef]"), as a range ("[a-f0-9]"),
       or as the combination these ("[a-f0-9XYZ]").  Additionally, many implementations support named character classes such as "[[:xdigit:]]".
       Character sets may be negated with an initial '!' ("[![:space:]]").

       Locale influences the meaning of fnmatch() patterns.

CAVEATS

       Most UNIX-like systems provide an fnmatch implementation.  This module will not work on platforms lacking an implementation, most notably
       Win32.

SEE ALSO

       File::Glob, POSIX::setlocale, fnmatch(3)

AUTHOR

       Michael J. Pomraning

       Please report bugs to <mjp-perl AT pilcrow.madison.wi.us>

COPYRIGHT AND LICENSE

       Copyright 2005 by Michael J. Pomraning

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.14.2							    2005-03-30							      FnMatch(3pm)

Check Out this Related Man Page

FNMATCH(3)						   BSD Library Functions Manual 						FNMATCH(3)

NAME

     fnmatch -- test whether a filename or pathname matches a shell-style pattern

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <fnmatch.h>

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

DESCRIPTION

     The fnmatch() function matches patterns according to the rules used by the shell.	It checks the string specified by the string argument to
     see if it matches the pattern specified by the pattern argument.

     The flags argument modifies the interpretation of pattern and string.  The value of 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 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 ordi-
		   nary character.

     FNM_PATHNAME  Slash characters in string must be explicitly matched by slashes in pattern.  If this flag is not set, then slashes are treated
		   as regular characters.

     FNM_PERIOD    Leading periods in string must be explicitly matched by periods in pattern.	If this flag is not set, then leading periods are
		   treated as regular characters.  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.

     FNM_LEADING_DIR
		   Ignore ``/*'' rest after successful pattern matching.

     FNM_CASEFOLD  Ignore case distinctions in both the pattern and the string.

RETURN VALUES

     The fnmatch() function returns zero if string matches the pattern specified by pattern.  It returns the value FNM_NOMATCH if no match is
     found.  Otherwise, another non-zero value is returned on error.

LEGACY RETURN VALUES

     The fnmatch() function returns zero if string matches the pattern specified by pattern; otherwise, it returns the value FNM_NOMATCH.

SEE ALSO

     sh(1), glob(3), regex(3)

STANDARDS

     The current implementation of the fnmatch() function does not conform to IEEE Std 1003.2 (``POSIX.2'').  Collating symbol expressions, equiv-
     alence class expressions and character class expressions are not supported.

HISTORY

     The fnmatch() function first appeared in 4.4BSD.

BUGS

     The pattern '*' matches the empty string, even if FNM_PATHNAME is specified.

BSD
								   July 18, 2004							       BSD

Linux and UNIX Man Pages

file::fnmatch(3pm) [debian man page]

Check Out this Related Man Page