int queue_enqueue( struct queue_state *qs, void *user_data );
struct queue_state *qs
- A queue state as allocated by queue_new.
- A void pointer of user data which will be queued into the queue.
Returns 1 on a successful enqueue. Returns 0 if enqueing failed. Enqueuing only fails if the queue has exhausted its supply of freelist elements. In this case, the user can call queue_guaranteed_enqueue, which will allocate a new element and enqueue using that. Remember however that the queue can never shrink, so any such call will permanently increase the size of the queue by one element.