r6.1.0:lfds610_queue_new
Jump to navigation
Jump to search
Source Files
/liblfds610/src/lfds610_queue/lfds610_queue_new.c /liblfds610/inc/liblfds610.h
Prototype
int lfds610_queue_new( struct lfds610_queue_state **qs, lfds610_atom_t number_elements );
Parameters
struct lfds610_queue_state **qs
- The address of a pointer onto which the function allocates the state which represents this queue. The pointer is set to NULL if queue creation fails.
lfds610_atom_t number_elements
- The maximum number of elements which can be present in the queue. If not all elements could be allocated (malloc() fails), qeue creation fails.
Return Value
Returns 1 on success and 0 on failure, with *qs being set to NULL on failure.
Notes
This function instantiates a queue. After instantiation any thread (except the instantiating thread) must before using the queue first call lfds610_queue_use.