Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-190
FILENAME_MATCH_ Procedure
FILENAME_MATCH_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Examples
Related Programming Manual
Summary
The FILENAME_MATCH_ procedure determines whether one or more contiguous
sections of a file name match the corresponding sections of a file-name pattern (that is,
whether the file name sections might be represented by the pattern sections).
FILENAME_MATCH_ does not resolve partially qualified file names.
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
status returned value
INT
returns a value indicating the result of the operation. Valid values are:
2 Match; the name fits the pattern.
1 Partial match; the name fits the left-hand pattern sections.
0 No match; the name does not fit the pattern.
<0 An error occurred; one of the following values is returned:
-1 Missing
filename parameter
#include <cextdecs(FILENAME_MATCH_)>
short FILENAME_MATCH_ ( const char *filename
,short length
,const char *pattern
,short length
,[ short *generic-set ] );
status := FILENAME_MATCH_ ( filename:length ! i:i
,pattern:length ! i:i
,[ generic-set ] ); ! o