Guardian Procedure Calls Reference Manual

FILENAME_TO_OLDFILENAME_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
The FILENAME_TO_OLDFILENAME_ procedure converts a file name to the C-series internal file-name
format. See Appendix D: File Names and Process Identifiers for descriptions of C-series and D-series
file names.
Syntax for C Programmers
#include <cextdecs(FILENAME_TO_OLDFILENAME_)>
short FILENAME_TO_OLDFILENAME_ ( const char *filename
,short length
,short *oldstyle-name );
Syntax for TAL Programmers
error := FILENAME_TO_OLDFILENAME_ ( filename:length ! i:i
,oldstyle-name ); ! o
Parameters
filename:length
input:input
STRING .EXT:ref:*, INT:value
specifies the valid file name to be converted. The value of filename must be exactly length
bytes long. If the name is partially qualified, it is resolved using the contents of the user's
=_DEFAULTS DEFINE. See caution under Considerations.
oldstyle-name
output
INT .EXT:ref:12
returns the internal-format file name.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
594 Guardian Procedure Calls (F)