Guardian Procedure Calls Reference Manual

NEXTFILENAME Procedure (Superseded by FILENAME_FINDNEXT_
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Returned Value
Considerations
Example
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The NEXTFILENAME procedure is used to obtain the name of the next disk file on a designated
volume. NEXTFILENAME returns the next file name in alphabetic sequence after the file name
supplied as the parameter. The alphabetic sequence includes digits 0-9; if the volume contains
temporary files, the first temporary file is returned when file-name is $volname (blank-fill).
The intended use of NEXTFILENAME is in an iterative loop, where the file name returned in one
call to NEXTFILENAME specifies the starting point for the alphabetic search in the subsequent call
to NEXTFILENAME. In this manner, a volume's file names are returned to the application process
in alphabetic order through successive calls to NEXTFILENAME.
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
error := NEXTFILENAME ( file-name ); ! i,o
Parameter
file-name
input, output
INT:ref:12
on the call, is the internal-format file name from which the search for the next file name begins.
file-name on the initial call can be one of these forms.
To obtain the name of the first file on $volname:
$volname (blank-fill)file-name[0:11]
or
\.sysnum volname (blank-fill)
To obtain the name of the first file in subvol-name on $volume:
$volname (blank-fill)file-name[0:3]
or
NEXTFILENAME Procedure (Superseded by FILENAME_FINDNEXT_ Procedure) 863