ck_array_put_unique(3)

Usage

#include <ck_array.h>

int

ck_array_put_unique(ck_array_t *array, void *pointer);

Library

Concurrency Kit (libck, -lck)

Overview

The ck_array_put_unique(3) function will attempt to insert the value of pointer into the array pointed to by 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.

Releases

Unchanged in 5 releases since Debian 8 (Jessie).

8–13

ck_array_init(3) initialize a pointer array ck_array_commit(3) linearization point for mutations before commit call ck_array_put(3) attempt immediate or deferred insertion of a pointer into array ck_array_remove(3) attempt immediate or deferred removal of a pointer from an array ck_array_deinit(3) destroy and deinitialize a pointer array ck_array_length(3) returns the number of pointers committed to an array ck_array_buffer(3) return length and pointer to array of reader-visible pointers ck_array_initialized(3) indicates whether an array was recently initialized or deinitialized CK_ARRAY_FOREACH(3) iterate through an array

Referred to by

ck_array_put(3) attempt immediate or deferred insertion of a pointer into array ck_array_init(3) initialize a pointer array ck_array_buffer(3) return length and pointer to array of reader-visible pointers ck_array_commit(3) linearization point for mutations before commit call ck_array_deinit(3) destroy and deinitialize a pointer array ck_array_length(3) returns the number of pointers committed to an array ck_array_remove(3) attempt immediate or deferred removal of a pointer from an array CK_ARRAY_FOREACH(3) iterate through an array ck_array_initialized(3) indicates whether an array was recently initialized or deinitialized