NAME

ck_hs_grow —

enlarge hash set capacity

LIBRARY

Concurrency Kit (libck, -lck)

SYNOPSIS

#include <ck_hs.h>

bool
ck_hs_grow(ck_hs_t *hs, unsigned long capacity);

DESCRIPTION

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.