Guardian Procedure Calls Reference Manual

DEFINENEXTNAME Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Returned Value
Considerations
Example
Summary
The DEFINENEXTNAME procedure returns the name of the DEFINE that follows the specified
DEFINE (in ASCII order).
Syntax for C Programmers
#include <cextdecs(DEFINENEXTNAME)>
short DEFINENEXTNAME ( char *define-name );
Syntax for TAL Programmers
error := DEFINENEXTNAME ( define-name ); ! i,o
Parameter
define-name
input, output
STRING .EXT:ref:24
on input, is a DEFINE name. It need not name an existing DEFINE. The name must be left-justified
and padded on the right with blanks. Trailing blanks are ignored.
On output, is the name of the DEFINE following the input DEFINE name in the process context
(in ASCII order); if define-name is blank on input, the name of the first DEFINE is returned.
Returned Value
INT
Outcome of the call:
Success.0
A syntax error occurred in name.2049
DEFINE not found.2051
Unable to obtain file-system buffer space.2052
Parameter address is bad.2054
Missing parameter.2066
No more DEFINEs.2060
For other error values associated with DEFINEs, see the Guardian Procedure Errors and Messages
Manual.
272 Guardian Procedure Calls (D-E)