Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (D-F)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
5-52
FILENAME_COMPARE_
Compares two file names to determine if they refer to the same object.
FILENAME_DECOMPOSE_
Extracts and returns one or more parts of a file-name or file name pattern.
< (CCL) An error occurred (see error-code).
= (CCE) FILEINQURE was successful.
> (CCG) One or more of the items requested are invalid for the file’s device type, file
type, open status, or other characteristic.
error := FILENAME_COMPARE_ ( filename1:length
,filename2:length );
error, INT returned value
-1 The file names do not refer to the same object.
0 The file names refer to the same object.
>0 A file-system error prevented evaluation; the returned value is the file-system
error number.
filename1:length, STRING .EXT:ref:*,INT:value input:input
filename2:length, STRING .EXT:ref:*,INT:value input:input
error := FILENAME_DECOMPOSE_ ( filename:length
,piece:maxlen
,piece-length
,level
,[ options ]
,[ subpart ] );
error, INT returned value
filename:length, STRING .EXT:ref:*,INT:value input:input
piece:maxlen, STRING .EXT:ref:*,INT:value output:input
piece-length, INT .EXT:ref:1 output
level, INT:value input