r6.1.0:lfds610_stack_clear

From liblfds.org
Jump to navigation Jump to search

Source Files

/liblfds610/src/lfds610_stack/lfds610_stack_delete.c
/liblfds610/inc/liblfds610.h

Prototype

void lfds610_stack_clear( struct lfds610_stack_state *ss,
                        void (*user_data_clear_function)(void *user_data, void *user_state),
                        void *user_state );

Parameters

struct lfds610_stack_state *ss

A stack state as allocated by lfds610_stack_new.

void (*user_data_init_function)(void *user_data, void *user_state)

A callback function, which can be NULL. This function is called with the user data void pointer from each element before that element is popped, giving the user an opportunity to delete any allocated state.

void *user_state

This pointer is passed into the user_data_init_function as its second argument, enabling the caller to pass state into the callback function.

Return Value

No return value.

Notes

This function empties the stack, popping every element. Each element, after being popped, is passed to user_data_clear_function.

See Also