ck_hs_grow(3)

Usage

#include <ck_hs.h>

bool

ck_hs_grow(ck_hs_t *hs, unsigned long capacity);

Library

Concurrency Kit (libck, -lck)

Overview

The ck_hs_grow(3) function will resize the hash set in order to be able to store at least the number of entries specified by capacity at a load factor of one. The default hash set load factor is 0.5. If you wish to minimize the likelihood of memory allocations for a hash set meant to store n entries, then specify a capacity of 2n. The default behavior of ck_hs is to round capacity to the next power of two if it is not already a power of two.

Return values

Upon successful completion, ck_hs_grow(3) returns true and otherwise returns false on failure.

Errors

Behavior is undefined if hs is uninitialized. This function will only return false if there are internal memory allocation failures.

Releases

Unchanged in 5 releases since Debian 8 (Jessie).

8–13

ck_hs_init(3) initialize a hash set ck_hs_move(3) move one from hash set to another ck_hs_destroy(3) destroy hash set CK_HS_HASH(3) invoke hash function with hash set seed ck_hs_iterator_init(3) initialize hash set iterator ck_hs_next(3) iterate to next entry in hash set ck_hs_get(3) load a key from a hash set ck_hs_put(3) store unique key into a hash set ck_hs_put_unique(3) unconditionally store unique key into a hash set ck_hs_set(3) store key into a hash set ck_hs_fas(3) fetch and store key in hash set ck_hs_remove(3) remove key from a hash set ck_hs_rebuild(3) rebuild a hash set ck_hs_gc(3) perform maintenance on a hash set ck_hs_count(3) returns number of entries in hash set ck_hs_reset(3) remove all keys from a hash set ck_hs_reset_size(3) remove all keys from a hash set ck_hs_stat(3) get hash set status

Referred to by

ck_hs_gc(3) perform maintenance on a hash set ck_hs_fas(3) fetch and store key in hash set ck_hs_get(3) load a key from a hash set ck_hs_put(3) store unique key into a hash set ck_hs_set(3) store key into a hash set CK_HS_HASH(3) invoke hash function with hash set seed ck_hs_init(3) initialize a hash set ck_hs_move(3) move one from hash set to another ck_hs_next(3) iterate to next entry in hash set ck_hs_stat(3) get hash set status ck_hs_apply(3) apply a function to hash set value ck_hs_count(3) returns number of entries in hash set ck_hs_reset(3) remove all keys from a hash set ck_hs_remove(3) remove key from a hash set ck_hs_destroy(3) destroy hash set ck_hs_rebuild(3) rebuild a hash set ck_hs_put_unique(3) unconditionally store unique key into a hash set ck_hs_reset_size(3) remove all keys from a hash set ck_hs_iterator_init(3) initialize hash set iterator