Guardian Procedure Calls Reference Manual

FILENAME_DECOMPOSE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Examples
Related Programming Manual
Summary
The FILENAME_DECOMPOSE_ procedure extracts and returns one or more parts of a file name
or file-name pattern.
Syntax for C Programmers
#include <cextdecs(FILENAME_DECOMPOSE_)>
short FILENAME_DECOMPOSE_ ( const char *filename
,short length
,char *piece
,short maxlen
,short *piece-length
,short level
,[ short options ]
,[ short subpart ] );
Syntax for TAL Programmers
error := FILENAME_DECOMPOSE_ ( filename:length ! i:i
,piece:maxlen ! o:i
,piece-length ! o
,level ! i
,[ options ] ! i
,[ subpart ] ); ! i
Parameters
filename:length
input:input
STRING .EXT:ref:*, INT:value
specifies the valid file name or file-name pattern from which a piece is extracted. The value of
filename must be exactly length bytes long. See caution under Considerations.
piece:maxlen
output:input
STRING .EXT:ref:*, INT:value
returns the extracted piece of filename. maxlen is the length in bytes of the string variable
piece.
566 Guardian Procedure Calls (F)