Guardian Procedure Calls Reference Manual

FILENAME_UNRESOLVE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Examples
Related Programming Manual
Summary
The FILENAME_UNRESOLVE_ procedure accepts a file name as input, deletes left-hand sections
that match the default values, and returns a file name that is semantically equivalent to the input
file name.
Syntax for C Programmers
#include <cextdecs(FILENAME_UNRESOLVE_)>
short FILENAME_UNRESOLVE_ ( const char *longname
,short length
,char *shortname
,short maxlen
,short *shortname-length
,[ short level ]
,[ const char *defaults ]
,[ short defaults-length ] );
• Some character-string parameters to FILENAME_UNRESOLVE_ are followed by a parameter
that specifies the length in bytes of the character string. Where the parameters are optional,
the character-string parameter and the corresponding length parameter must either both be
supplied or both be absent.
Syntax for TAL Programmers
error := FILENAME_UNRESOLVE_ ( longname:length ! i:i
,shortname:maxlen ! o:i
,shortname-length ! o
,[ level ] ! i
,[ defaults:defaults-length ] ); ! i:i
Parameters
longname:length
input:input
STRING .EXT:ref:*, INT:value
contains the valid file name or file-name pattern to be acted upon by FILENAME_UNRESOLVE_.
The value of longname must be exactly length bytes long. See caution under Considerations.
602 Guardian Procedure Calls (F)