int stack_new( struct stack_state **ss, atom_t number_elements );
struct stack_state **ss
- A pointer to a pointer onto which is allocated the state which represents this stack. Set to NULL if stack creation fails.
- The maximum number of elements which can be present in the stack. These elements will be allocated when the stack is created. If not all elements could be allocated (malloc() fails), stack creation fails.
Returns 1 on success and 0 on failure, with *ss being set to NULL on failure.
This function instantiates a stack.