Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-193
FILENAME_RESOLVE_ Procedure
FILENAME_RESOLVE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Example
Related Programming Manual
Summary
The FILENAME_RESOLVE_ procedure converts a partially qualified file name to a fully
qualified file name. You can supply a search list when qualifying a disk file name. You
can also use FILENAME_RESOLVE_ to resolve absent sections of a file-name pattern
or to resolve a DEFINE that contains a file name and can be opened. Refer to
Appendix D, File Names and Process Identifiers
for the definitions of file name and file-
name pattern. Refer to Appendix E, DEFINEs
f or further information about DEFINEs.
Syntax for C Programmers
•
Some character-string parameters to FILENAME_RESOLVE_ are followed by a
parameter
length that specifies the length in bytes of the character string (not
counting the null-byte terminator). Where the parameters are optional, the
character-string parameter and the corresponding length parameter must either
both be supplied or both be absent.
#include <cextdecs(FILENAME_RESOLVE_)>
short FILENAME_RESOLVE_ ( const char *partialname
,short length
,char *fullname
,short maxlen
,short *fullname-length
,[ short options ]
,[ const char *override-name ]
,[ short length ]
,[ const char *search ]
,[ short length ]
,[ const char *defaults ]
,[ short length ] );