Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (N)
Guardian Procedure Calls Reference Manual—522629-013
10-32
NEXTFILENAME Procedure
(Superseded by FILENAME_FINDNEXT_
NEXTFILENAME Procedure
(Superseded by FILENAME_FINDNEXT_
Procedure )
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Example
Summary
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
Parameters
error returned value
INT
is a file-system error number indicating the outcome of the call. Common errors
returned are:
Note. This procedure is supported for compatibility with previous software and should not be
used for new development.
error := NEXTFILENAME ( file-name ); ! i,o