DragonFly On-Line Manual Pages

CK_RHS_GROW(3)        DragonFly Library Functions Manual        CK_RHS_GROW(3)

NAME
     ck_rhs_grow - enlarge hash set capacity

LIBRARY
     Concurrency Kit (libck, -lck)

SYNOPSIS
     #include <ck_rhs.h>

     bool
     ck_rhs_grow(ck_rhs_t *hs, unsigned long capacity);

DESCRIPTION
     The ck_rhs_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_rhs 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_rhs_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.

SEE ALSO
     ck_rhs_init(3), ck_rhs_move(3), ck_rhs_destroy(3), CK_RHS_HASH(3),
     ck_rhs_iterator_init(3), ck_rhs_next(3), ck_rhs_get(3), ck_rhs_put(3),
     ck_rhs_put_unique(3), ck_rhs_set(3), ck_rhs_fas(3), ck_rhs_remove(3),
     ck_rhs_rebuild(3), ck_rhs_gc(3), ck_rhs_count(3), ck_rhs_reset(3),
     ck_rhs_reset_size(3), ck_rhs_stat(3)

     Additional information available at http://concurrencykit.org/

                              September 17, 2012