Clara-Doc - Method Reference

 / packages  / CTBASE  / Version 01.00.00  / CTSTK

CTSTK_IterStart
Description
Prepares a stack instance for an iteration loop.

Prototype

			     DCTSTK_IterStart...
     D                 PR            10I 0
     D@This                            *   Value
						
Parameters
@This
TypePointer (*)
Passing ModeValue
DescriptionThe address of a stack instance. This pointer MUST be obtained through a call to CTSTK_Constructor.
Return Values

Symbolic ConstantValueDescription
CS_SUCCESS0The next item to be read in an iteration loop will be the first item in the stack. This means the stack has at least one item.
CS_FAILURE1The specified stack instance is empty. The stack cannot be read from.