Guardian Procedure Calls Reference Manual

FNAMECOLLAPSE Procedure (Superseded by
OLDFILENAME_TO_FILENAME_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The FNAMECOLLAPSE procedure converts a file name from internal to external form. The system
number of a network file name is converted to the corresponding system name.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be used for
new development. This procedure is supported only for compatibility with previous software.
Syntax for TAL Programmers
length := FNAMECOLLAPSE ( internal-name ! i
,external-name ); ! o
Parameters
internal-name
input
INT:ref:12
is the name to be converted. internal-name is an array of 12 words. internal-name
cannot be the same array as external-name. For a description of valid internal file names,
see Appendix D: File Names and Process Identifiers.
external-name
output
STRING:ref:26 or STRING:ref:34
returns the external form of internal-name. If internal-name is a local file name,
external-name contains a maximum of 26 bytes; if a network name is converted,
external-name contains a maximum of 34 bytes. See the FNAMEEXPAND procedure
Considerations (page 619) for a discussion of the conversion of file names.
Returned Value
INT
The length (in bytes) of external-name.
FNAMECOLLAPSE Procedure (Superseded by OLDFILENAME_TO_FILENAME_ Procedure) 613