Clara-Doc - Method Reference
CTSTK_Push
Description
Inserts an item in a stack instance.
Prototype
DCTSTK_Push...
D PR 10I 0
D@This * Value
D@Value * Value
D@Bytes 10I 0 Value
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 the buffer that holds the item to be inserted in the stack instance. |
@Bytes
| Type | 10I 0 |
| Passing Mode | Value |
| Description | The size in bytes of the item to be inserted. |
Return Values
| Symbolic Constant | Value | Description |
| CS_SUCCESS | 0 | The item has been inserted successfully. |
| CS_FAILURE | 1 | The item could not be inserted. The maximum number of items allowed in the stack has already been reached. |