Guardian Procedure Calls Reference Manual

PATHNAME_TO_FILENAME_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
OSS Considerations
Example
Related Programming Manual
Summary
The PATHNAME_TO_FILENAME_ procedure converts an OSS pathname to a Guardian file name.
For a description of the OSS pathname syntax, see Appendix D: File Names and Process Identifiers.
Syntax for C Programmers
#include <cextdecs(PATHNAME_TO_FILENAME_)>
short PATHNAME_TO_FILENAME_ ( const char *path
,char *filename
,short maxlen
,short *length
,[ short *infoflags ] );
Syntax for TAL Programmers
error := PATHNAME_TO_FILENAME_ ( pathname ! i
,filename:maxlen ! o:i
,length ! o
,[ info-flags ] ); ! o
Parameters
pathname
input
STRING .EXT:ref:*
is the null-terminated OSS pathname to be converted into its corresponding Guardian file name.
filename:maxlen
output:input
STRING .EXT:ref:*, INT:value
returns the Guardian file name that corresponds to pathname. The file name is not
null-terminated; its length is returned in length.
maxlen specifies the maximum length in bytes of the name that can be returned in filename.
If maxlen is not large enough, error returns 563 (buffer too small) and length returns the
actual length of the name.
filename contains a null string if pathname does not correspond to a Guardian file name.
In this case, the value returned in error is 0.
934 Guardian Procedure Calls (P)