Guardian Procedure Calls Reference Manual

FILENAME_MATCH_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
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
#include <cextdecs(FILENAME_MATCH_)>
short FILENAME_MATCH_ ( const char *filename
,short filename-length
,const char *pattern
,short pattern-length
,[ short *generic-set ] );
Syntax for TAL Programmers
status := FILENAME_MATCH_ ( filename:filename-length ! i:i
,pattern:pattern-length ! i:i
,[ generic-set ] ); ! o
Parameters
filename:filename-length
input:input
STRING .EXT:ref:*, INT:value
is one or more contiguous sections of a valid file name that is to be tested for a match with
pattern. The value of filename must be exactly filename-length bytes long. It must
have the same level of left-hand qualification as pattern or else a match cannot result (for
example, if pattern starts with a node-name section, filename must have a node name).
See caution under Considerations.
pattern:pattern-length
input:input
STRING .EXT:ref:*, INT:value
is one or more contiguous sections of a valid file-name pattern to be matched. The value of
pattern must be exactly pattern-length bytes long. For the definition of file-name pattern,
see Appendix D: File Names and Process Identifiers. See caution under Considerations.
FILENAME_MATCH_ Procedure 583