ck_array_put_unique(3)
attempt immediate or deferred insertion of a unique pointer into array
LIBRARY
Concurrency Kit (libck, -lck)
SYNOPSIS
In ck_array.h
Ft int
Fn ck_array_put_unique ck_array_t *array void *pointer
DESCRIPTION
The
Fn ck_array_put_unique 3
function will attempt to insert the value of
Fa pointer
into the array pointed to by
Fa array .
This function may incur additional memory allocations
if not enough memory has been allocated in the array
for a new entry. The operation is also free to apply
the operation immediately if there is an opportunity
for elimination with a pending (uncommitted) remove
operation. The function will not make any modifications
if the pointer already exists in the array.
RETURN VALUES
This function returns 1 if the pointer already exists in the array.
It returns 0 if the put operation succeeded. It returns -1 on
error due to internal memory allocation failures.