Guardian Programming Reference Summary for C

Functions Summary (D-F)
Guardian Programming Reference Summary for C—522630-001
5-43
FILENAME_MATCH_
Determines whether one or more contiguous sections of a file name match the
corresponding sections of a file name pattern.
error
generic-set
Bit 13 If device-subtype is supplied, a file name must not match the device
subtype value to be returned.
Bit 14 If device-type is supplied, a file name must not match the device type
value to be returned.
Bit 15 If startname is supplied, and if the first name returned would be
startname, then that name is to be skipped and the following name should
be returned.
#include <cextdecs(FILENAME_MATCH_)>
short FILENAME_MATCH_ ( const char *filename /* i */
,short length /* i */
,const char *pattern /* i */
,short length /* i */
,[ short *generic-set ] );/* o */
2 = Match; name fits pattern.
1 = Partial match; name fits lefthand pattern sections.
0 = No match; name does not fit pattern.
<0 = An error occurred:
-1 = Missing name parameter.
-2 = Missing pattern parameter.
-3 = Length error on name parameter.
-4 = Length error on pattern parameter.
-5 = Bounds error on generic-set parameter.
-1 = The name falls before the first possible match.
0 = The name falls within the set of possible matches.
1 =; The name falls after the last possible match.