Clara-Doc - Method Reference
CTSTK_IterNext
Description
Moves to the next available stack item within an iteration loop.
Prototype
DCTSTK_IterNext...
D PR 10I 0
D@This * Value
D@Value * Value
D@Bytes 10I 0
Parameters
@This
| Type | Pointer (*) |
| Passing Mode | Value |
| Description | The address of a stack instance. This pointer MUST be obtained through a call to CTSTK_Constructor. |
@Value
| Type | Pointer (*) |
| Passing Mode | Value |
| Description | The address of a buffer where the next stack item will be copied. |
@Bytes
| Type | 10I 0 |
| Passing Mode | Reference |
| Description | The size in bytes of the caller-supplied buffer. On return, this parameter will hold the actual size of the stack item. The method will not copy more than @Bytes in the @Value parameter even if the stack item is larger. |
Return Values
| Symbolic Constant | Value | Description |
| CS_SUCCESS | 0 | The next available stack item has been copied in the caller-supplied buffer. The item itself remains in the stack. |
| CS_FAILURE | 1 | We are at the end of the iteration loop; there was no item left to retrieve from the stack. |