fpattern.h

/******************************************************************************
* fpattern.h
*	Functions for matching filename patterns to filenames.
*
* Usage
*	Filename patterns are composed of regular (printable) characters which
*	may comprise a filename, as well as special pattern matching characters:
*
*	    .		Matches a period (.).
*			Note that a period in a filename is not treated any
*			differently than any other character.
*
*	    ?		Any.
*			Matches any single character except '/' or '\'.
*
*	    *		Closure.
*			Matches zero or more occurences of any characters other
*			than '/' or '\'.  Leading '*' characters are allowed.
*
*	    SUB		Substitute (control-Z).
*			Similar to '*', this matches zero or more occurences of
*			any characters other than '/', '\', or '.'.  Leading
*			'^Z' characters are allowed.
*
*	    [ab]	Set.
*			Matches the single character 'a' or 'b'.
*			If the dash '-' character is to be included, it must
*			immediately follow the opening bracket '['.  If the
*			closing bracket ']' character is to be included, it must
*			be preceded by a quote '`'.
*
*	    [a-z]	Range.
*			Matches a single character in the range 'a' to 'z'.
*			Ranges and sets may be combined within the same set of
*			brackets.
*
*	    [!R]	Exclusive range.
*			Matches a single character not in the range 'R'.
*			If range 'R' includes the dash '-' character, the dash
*			must immediately follow the caret '!'.
*
*	    !		Not.
*			Makes the following pattern (up to the next '/') match
*			any filename except those what it would normally match.
*
*	    /		Path separator (UNIX and DOS).
*			Matches a '/' or '\' pathname (directory) separator.
*			Multiple separators are treated like a single separator.
*			A leading separator indicates an absolute pathname.
*
*	    \		Path separator (DOS).
*			Same as the '/' character.  Note that this character
*			must be escaped if used within string constants ("\\").
*
*	    \		Quote (UNIX).
*			Makes the next character a regular (nonspecial)
*			character.  Note that to match the quote character
*			itself, it must be quoted.  Note that this character
*			must be escaped if used within string constants ("\\").
*
*	    `		Quote (DOS).
*			Makes the next character a regular (nonspecial)
*			character.  Note that to match the quote character
*			itself, it must be quoted.
*
*	Upper and lower case alphabetic characters are considered identical,
*	i.e., 'a' and 'A' match each other.  (What constitutes a lowercase
*	letter depends on the current locale settings.)
*
*	Spaces and control characters are treated as normal characters.
*
* Examples
*	The following patterns in the left column will match the filenames in
*	the middle column and will not match filenames in the right column:
*
*	    Pattern	Will Match			Will Not Match
*	    -------	----------			--------------
*	    a		a (only)			(anything else)
*	    a.		a. (only)			(anything else)
*	    a?c		abc, acc, arc, a.c		a, ac, abbc
*	    a*c		ac, abc, abbc, acc, a.c		a, ab, acb, bac
*	    a*		a, ab, abb, a., a.b		b, ba
*	    *		a, ab, abb, a., .foo, a.foo	(nothing)
*	    *.		a., ab., abb., a.foo.		a, ab, a.foo, .foo
*	    *.*		a., a.b, ah.bc.foo		a
*	    ^Z		a, ab, abb			a., .foo, a.foo
*	    ^Z.		a., ab., abb.			a, .foo, a.foo
*	    ^Z.*	a, a., .foo, a.foo		ab, abb
*	    *2.c	2.c, 12.c, foo2.c, foo.12.c	2x.c
*	    a[b-z]c	abc, acc, azc (only)		(anything else)
*	    [ab0-9]x	ax, bx, 0x, 9x			zx
*	    a[-.]b	a-b, a.b (only)			(anything else)
*	    a[!a-z]b	a0b, a.b, a@b			aab, azb, aa0b
*	    a[!-b]x	a0x, a+x, acx			a-x, abx, axxx
*	    a[-!b]x	a-x, a!x, abx (only)		(anything else)
*	    a[`]]x	a]x (only)			(anything else)
*	    a``x	a`x (only)			(anything else)
*	    oh`!	oh! (only)			(anything else)
*	    is`?it	is?it (only)			(anything else)
*	    !a?c	a, ac, ab, abb, acb, a.foo      abc, a.c, azc
*
* History
*	1.0, 1997-01-03, David Tribble.
*	First cut.
*
*	1.1, 1997-01-03, David Tribble.
*	Added '^Z' pattern character.
*	Added fpattern_matchn().
*
*	1.2, 1997-01-26, David Tribble.
*	Changed range negation character from '^' to '!', ala Unix.
*
*	1.3, 1997-08-02, David Tribble.
*	Added 'FPAT_XXX' macro constants.
*
*	1.4, 2001-11-21, David Tribble.
*	Revised slightly for Win32 compilations.
*
* Limitations
*	This code is copyrighted by the author, but permission is hereby granted
*	for its unlimited use provided that the original copyright and
*	authorship notices are retained intact.
*
*	Queries about this source code can be sent to <david@tribble.com>.
*
* Copyright ©1997-2001 by David R. Tribble, all rights reserved.
*/


#ifndef drt_fpattern_h
#define drt_fpattern_h	1

#ifdef __cplusplus
extern "C"
{
#endif


/* Identification */

#ifndef NO_H_IDENT
static const char	drt_fpattern_h_id[] =
    "@(#)drt/src/lib/fpattern.h $Revision: 1.4 $ $Date: 2001/11/12 06:00:00 $";
#endif


/* Manifest constants */

#define FPAT_QUOTE	'\\'		/* Quotes a special char	*/
#define FPAT_QUOTE2	'`'		/* Quotes a special char	*/
#define FPAT_DEL	'/'		/* Path delimiter		*/
#define FPAT_DEL2	'\\'		/* Path delimiter		*/
#define FPAT_DOT	'.'		/* Dot char			*/
#define FPAT_NOT	'!'		/* Exclusion			*/
#define FPAT_ANY	'?'		/* Any one char			*/
#define FPAT_CLOS	'*'		/* Zero or more chars		*/
#define FPAT_CLOSP	'\x1A'		/* Zero or more nondelimiters	*/
#define FPAT_SET_L	'['		/* Set/range open bracket	*/
#define FPAT_SET_R	']'		/* Set/range close bracket	*/
#define FPAT_SET_NOT	'!'		/* Set exclusion		*/
#define FPAT_SET_THRU	'-'		/* Set range of chars		*/


/* Model-dependent extern aliases */

#ifdef __MSDOS__

#if defined(__SMALL__)
 #define fpattern_isvalid	Sfpattern_isvalid
 #define fpattern_match		Sfpattern_match
 #define fpattern_matchn	Sfpattern_matchn
#elif defined(__LARGE__)
 #define fpattern_isvalid	Lfpattern_isvalid
 #define fpattern_match		Lfpattern_match
 #define fpattern_matchn	Lfpattern_matchn
#elif defined(__COMPACT__)
 #define fpattern_isvalid	Cfpattern_isvalid
 #define fpattern_match		Cfpattern_match
 #define fpattern_matchn	Cfpattern_matchn
#elif defined(__MEDIUM__)
 #define fpattern_isvalid	Mfpattern_isvalid
 #define fpattern_match		Mfpattern_match
 #define fpattern_matchn	Mfpattern_matchn
#elif defined(__HUGE__)
 #define fpattern_isvalid	Hfpattern_isvalid
 #define fpattern_match		Hfpattern_match
 #define fpattern_matchn	Hfpattern_matchn
#elif defined(__TINY__)
 #define fpattern_isvalid	Tfpattern_isvalid
 #define fpattern_match		Tfpattern_match
 #define fpattern_matchn	Tfpattern_matchn
#else
 /* Memory model is not defined, use extern names as is. */
#endif

#endif /* __MSDOS__ */


/* Public variables */

/* (None) */


/* Public functions */

extern int	fpattern_isvalid(const char *pat);
extern int	fpattern_match(const char *pat, const char *fname);
extern int	fpattern_matchn(const char *pat, const char *fname);


#ifdef __cplusplus
}
#endif

#endif /* drt_fpattern_h */

/* End fpattern.h */