r6.0.1:lfds601_stack_push

From liblfds.org
Jump to navigation Jump to search

Source Files

/liblfds601/src/lfds601_stack/lfds601_stack_push_pop.c
/liblfds601/inc/liblfds601.h

Prototype

int lfds601_stack_push( struct lfds601_stack_state *ss, void *user_data );

Parameters

struct lfds601_stack_state *ss

A stack state as allocated by lfds601_stack_new.

void *user_data

A void pointer of user data which will be pushed onto the stack.

Return Value

The return value is 1 upon successful push, 0 upon failure. Failure occurs only when the stack has exhausted its freelist of elements. In this case, the user can call lfds601_stack_guaranteed_push, which will allocate a new element and push using that. Remember however that the stack can never shrink, so any such call will permanently increase the size of the stack by one element.

Notes

No notes.

See Also