Guardian Procedure Calls Reference Manual

FNAMEEXPAND Procedure (Superseded by FILENAME_SCAN_ Procedure
and FILENAME_RESOLVE_ 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 FNAMEEXPAND procedure is used to expand a partial file name from the compacted external
form to the standard 12-word internal form usable by other file-system procedures.
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 := FNAMEEXPAND ( external-filename ! i
,internal-filename ! o
,default-names ); ! i
Parameters
external-filename
input
STRING:ref:27 or STRING:ref:35
is the file name to be expanded. The file name must be in the form:
[\sysname.]file-name or definename
followed by a delimiter, and where file-name is in one of these forms:
[$volname.][subvol-name.]file-id
$processname[.#1st-qualif-name[.2nd-qualif-name]]
$devname
$ldevnum
The delimiter that follows file-name can be any character that is not valid as part of an
external file name, such as blank or null. When the external-filename is 34 characters
and a delimiter is required, the length of the external-filename expands to 35 characters.
When \system is present, $volname cannot consist of eight characters unless \system is
the local system and default-names does not include a system number. In that case the
output name is in local form.
618 Guardian Procedure Calls (F)