Guardian Procedure Calls Reference Manual

FILENAME_RESOLVE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
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. For the definitions of file name and file-name pattern,
see Appendix D: File Names and Process Identifiers. For further information about DEFINEs, see
Appendix E: DEFINEs.
Syntax for C Programmers
#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 override-length ]
,[ const char *search ]
,[ short search-length ]
,[ const char *defaults ]
,[ short defaults-length ] );
• Some character-string parameters to FILENAME_RESOLVE_ are followed by a parameter 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.
Syntax for TAL Programmers
error := FILENAME_RESOLVE_ ( partialname:length ! i:i
,fullname:maxlen ! o:i
,fullname-length ! o
,[ options ] ! i
,[ override-name:override-length ] ! i:i
,[ search:search-length ] ! i:i
,[ defaults:defaults-length ] ); ! i:i
586 Guardian Procedure Calls (F)