r6.1.0:lfds610_freelist_guaranteed_pop

From liblfds.org
Revision as of 14:07, 4 January 2015 by Admin (talk | contribs) (1 revision imported)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Source Files

/liblfds610/src/lfds610_freelist/lfds610_freelist_pop_push.c
/liblfds610/inc/liblfds610.h

Prototype

struct lfds610_freelist_element *lfds610_freelist_guaranteed_pop( struct lfds610_freelist_state *fs, struct lfds610_freelist_element **fe );

Parameters

struct lfds610_freelist_state *fs

A freelist state as allocated by lfds610_freelist_new.

struct lfds610_freelist_element **fe

A pointer to a freelist element pointer which will be set to point to a freshly allocated struct freelist. Set to NULL if allocation fails.

Return Value

Returns a pointer to the address of the freelist element (e.g. the value *fe is set to). Returns NULL if element creation failed. This element is actually allocated, rather than being taken from the freelist, and so will always succeed, unless malloc or the user initialisation function fail. The user initialisation function used is that which was passed to lfds610_freelist_new when the freelist was instantiated.

Notes

To obtain the user data void pointer from the element, use lfds610_freelist_get_user_data_from_element.

See Also