r6.0.1:lfds601_stack_pop
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_pop( 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
- The address of a pointer into which the user data will be placed. If the stack is empty, *user_data is not modified, as NULL is a valid user data value.
Return Value
The return value is 1 upon successful pop, 0 upon unsuccessful pop. Popping fails only if the stack is empty. Note that on an unsuccessful pop, *user_data is untouched; it is not set to NULL, since NULL is a valid user data value. Only the return value indicates whether or not the pop was successful.
Notes
No notes.