ck_ht_grow_spmc(3)

ck_ht_grow_spmc3

Resize a hash table if necessary

Usage

#include <ck_ht.h>

bool

ck_ht_grow_spmc(ck_ht_t *ht, uint64_t capacity);

Library

Concurrency Kit (libck, -lck)

Overview

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

This function is safe to call in the presence of concurrent ck_ht_get_spmc(3) operations.

Return values

Upon successful completion ck_ht_grow_spmc() returns true and otherwise returns a false value.

Errors

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

Releases

Unchanged in 5 releases since Debian 8 (Jessie).

  1. 8–13

From libck-dev 0.7.2-6 in Debian 13 (Trixie). Parsed by carta from the page's mdoc source.