r6.0.1:lfds601_queue_dequeue
Jump to navigation
Jump to search
Source Files
/liblfds601/src/lfds601_queue/lfds601_queue_queue.c /liblfds601/inc/liblfds601.h
Prototype
int lfds601_queue_dequeue( struct lfds601_queue_state *qs, void **user_data );
Parameters
struct lfds601_queue_state *qs
- A queue state as allocated by lfds601_queue_new.
void **user_data
- The address of a pointer into which the user data will be placed. On an unsuccessful dequeue (which occurs if and only if the queue is empty), *user_data is not modified, as NULL is a valid user data value.
Return Value
Returns 1 if an element was dequeued, returns 0 if an element was no dequeued. The queue being empty is the only situation in which dequeuing does not occur. Note that on an unsuccessful dequeue, *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 dequeue was successful.
Notes
No notes.