MatchNext

Finds the next file or directory that matches a pattern (V36)

Locates the next file or directory that matches a given pattern. See <dos/dosasl.h> for more information. Various bits in the AnchorPath->ap_Flags field allow the application to control the operation of MatchNext().

See MatchFirst() for other notes.

AnchorPath

Placeholder for search. MUST be long word aligned!

error

0 for success or error code. (Opposite of most AmigaDOS calls)

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

MatchNext() will call MatchPatternNoCase(), which may end up using 1500 bytes of stack space. You should make sure that more than 1500 bytes of stack space are available before you call MatchNext().

MatchNext() will change the error code value which can be retrieved by IoErr() if the function fails. Note that the return value of MatchNext() already provides you with the error code, and you do not need to call IoErr().

See MatchFirst().

MatchFirst(), ParsePattern(), Examine(), CurrentDir(), Examine(), MatchEnd(), ExNext(), <dos/dos.h>, <dos/dosasl.h>