Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-170
FILENAME_DECOMPOSE_ Procedure
FILENAME_DECOMPOSE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
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
Syntax for TAL Programmers
Parameters
error returned value
INT
returns a file-system error number indicating the outcome of the operation.
#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 ] );
error := FILENAME_DECOMPOSE_ ( filename:length ! i:i
,piece:maxlen ! o:i
,piece-length ! o
,level ! i
,[ options ] ! i
,[ subpart ] ); ! i