FSH_WILDMATCH

This function provides the mechanism for using OS/2 wildcard semantics to form a match between an input string and a pattern, taking into account DBCS considerations.

Syntax

FSH_WILDMATCH(pPat, pStr)

Parameters

pPat: is the pointer to an ASCIIZ pattern string. Wildcards are present and are interpreted as described below.
ppStr: is the pointer to the test string.

Returns

If no error is detected, a zero error code is returned. If an error is detected, the following error code is returned:

ERROR_NO_META_MATCH : the wildcard match failed.

Calling Sequence

int far pascal FSH_WILDMATCH(pPat, pStr)

char far * pPat;
char far * pStr;

Remarks

Wildcards provide a general mechanism for pattern matching file names. There are two distinguished characters that are relevant to this matching. The '?' character matches one character (not bytes) except at a '.' or at the end of a string, where it matches zero characters. The '*' matches zero or more characters (not bytes) with no implied boundaries except the end-of-string.

For example, `a*b` matches `ab` and `aCCCCCCCCC` while `a?b` matches `aCb` but does not match `aCCCCCCCCCb`

See the section on meta characters in this document for additional information.

The FSD should uppercase the pattern and string before calling FSH_WILDMATCH to achieve a case-insensitive compare.

Note: OS/2 does not validate input parameters. An FSD, therefore, should call FSH_PROBEBUF where appropriate.