MatchPattern

Checks for a pattern match with a string (V36)

Checks for a pattern match with a string. The pattern must be a tokenized string output by ParsePattern(). This function is case-sensitive.

pat

Special pattern string to match as returned by ParsePattern()

str

String to match against given pattern

match

success or failure of pattern match. On failure, IoErr() will return 0 or ERROR_TOO_MANY_LEVELS (starting with V37 - before that there was no stack checking).

This function is highly recursive. You must have at least 1500 free bytes of stack to call it. It will cut off its recursion before going any deeper than that and return failure. This is _currently_ sufficient for about 100 levels deep of "#", "(", "~", etc.

MatchPattern() does not verify if sufficient stack space is available to perform its task. It is the responsibility of the caller to make sure that more than 1500 bytes of stack space will be available.

MatchPattern() may change the error code value which can be retrieved by IoErr() if the function fails.

It is not safe to call this function from a Task!

ParsePattern(), MatchPatternNoCase(), MatchFirst(), MatchNext()