Guardian Procedure Calls Reference Manual

FILENAME_SCAN_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
The FILENAME_SCAN_ procedure checks for valid file-name syntax and returns the length in bytes
of that part of the input string that constitutes a file name. Node names are accepted as valid input,
as are partially or fully qualified names of disk files, processes, and devices. File-name patterns
and subvolume names are accepted when you select the appropriate options. FILENAME_SCAN_
checks syntax only; no check for the existence of any entity is performed.
For the definitions of file name and file-name pattern, see Appendix D: File Names and Process
Identifiers.
Syntax for C Programmers
#include <cextdecs(FILENAME_SCAN_)>
short FILENAME_SCAN_ ( const char *string
,short length
,[ short *count ]
,[ short *kind ]
,[ short *entity-level ]
,[ short options ] );
Syntax for TAL Programmers
error := FILENAME_SCAN_ ( string:length ! i:i
,[ count ] ! o
,[ kind ] ! o
,[ entity-level ] ! o
,[ options ] ); ! i
Parameters
string:length
input:input
STRING .EXT:ref:*, INT:value
is a character string to be searched for a valid file name. string must be exactly length
bytes long. A valid file name must begin at the first character of string. It can occupy the
entire length of string, or it can occupy the left-hand portion of string and be followed
by characters that cannot appear in a valid file name or file-name pattern.
FILENAME_SCAN_ Procedure 591