Guardian Procedure Calls Reference Manual

FILENAME_EDIT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Examples
Related Programming Manual
Summary
The FILENAME_EDIT_ procedure modifies one or more parts of a file name or file-name pattern,
changing them to a specified value.
Syntax for C Programmers
#include <cextdecs(FILENAME_EDIT_)>
short FILENAME_EDIT_ ( char *filename
,short maxlen
,short *filename-length
,const char *piece
,short length
,short level
,[ short options ]
,[ short subpart ] );
Syntax for TAL Programmers
error := FILENAME_EDIT_ ( filename:maxlen ! i,o:i
,filename-length ! i,o
,piece:length ! i:i
,level ! i
,[ options ] ! i
,[ subpart ] ); ! i
Parameters
filename:maxlen
input, output:input
STRING .EXT:ref:*, INT:value
on input, is the file name or file-name pattern to be edited; on output, contains the edited version
of the file name or file-name pattern. The input must be a valid file name or valid file-name
pattern; it must not be a DEFINE name. For the definitions of file name and file-name pattern.
See caution under Considerations. See Appendix D: File Names and Process Identifiers.
maxlen is the length in bytes of the string variable filename.
FILENAME_EDIT_ Procedure 569