View source for r6.1.0:Lfds610 queue guaranteed enqueue

{{DISPLAYTITLE:r6.1.0:lfds610_queue_guaranteed_enqueue}}
==Source Files==
 /liblfds610/src/lfds610_queue/lfds610_queue_queue.c
 /liblfds610/inc/liblfds610.h

==Prototype==
 int lfds610_queue_guaranteed_enqueue( struct lfds610_queue_state *qs, void *user_data );

==Parameters==
''struct lfds610_queue_state *qs''
: A queue state as allocated by ''[[r6.1.0:lfds610_queue_new|lfds610_queue_new]]''.

''void *user_data''
: A void pointer of user data which will be queued into the queue.

==Return Value==
Returns 1 on a successful enqueue.  Returns 0 if enqueing failed.  Enqueuing only fails if ''malloc'' fails.

==Notes==
The function ''[[r6.1.0:lfds610_queue_enqueue|lfds610_queue_enqueue]]'' fails only when the queue's freelist is empty.  In this event, ''lfds610_queue_guaranteed_push'' can be called, which allocates a new element and enqueues using that new element, thus guaranteeing an enqueue, barring the event of ''malloc'' failure.

==See Also==
* [[r6.1.0:lfds610_queue|lfds610_queue]]
* [[r6.1.0:lfds610_queue_dequeue|lfds610_queue_dequeue]]