ck_ht_next(3)

Usage

#include <ck_ht.h>

bool

ck_ht_next(ck_ht_t *ht, ck_ht_iterator_t *iterator, ck_ht_entry_t **entry);

Library

Concurrency Kit (libck, -lck)

Overview

The ck_ht_next() function will increment the iterator object pointed to by iterator to point to the next non-empty hash table entry. If ck_ht_next() returns true then the pointer pointed to by entry is initialized to the current hash table entry pointed to by the iterator object.

It is expected that iterator has been initialized using the ck_ht_iterator_init(3) function or statically initialized using CK_HT_ITERATOR_INITIALIZER.

Return values

If ck_ht_next() returns true then the object pointed to by entry points to a valid hash table entry. If ck_ht_next() returns false then value of the object pointed to by entry is undefined.

Errors

Behavior is undefined if iterator or ht are uninitialized.

Releases

Unchanged in 5 releases since Debian 8 (Jessie).

8–13

ck_ht_stat(3) get hash table status ck_ht_init(3) initialize a hash table ck_ht_destroy(3) immediately destroy a hash table ck_ht_hash(3) generate a hash value for a hash table ck_ht_hash_direct(3) generate a hash value for a hash table ck_ht_set_spmc(3) store key-value pair into hash table ck_ht_put_spmc(3) store unique key-value pair into hash table ck_ht_gc(3) perform maintenance on a hash table ck_ht_get_spmc(3) load a key-value pair from a hash table ck_ht_grow_spmc(3) resize a hash table if necessary ck_ht_remove_spmc(3) resize a hash table if necessary ck_ht_count(3) return count of key-value pairs in hash table ck_ht_reset_spmc(3) remove all entries from a hash table ck_ht_reset_size_spmc(3) remove all entries from a hash table and reset size ck_ht_entry_empty(3) determine whether entry contains a key-value pair ck_ht_entry_key_set(3) initialize pointer to key in hash table entry ck_ht_entry_key_set_direct(3) initialize key value in hash table entry ck_ht_entry_key_length(3) returns the length of the key specified in the argument ck_ht_entry_key(3) return pointer to key as specified in hash table entry ck_ht_entry_set(3) initialize a key-value pair ck_ht_entry_set_direct(3) initialize a key-value pair ck_ht_entry_key_direct(3) return key value as specified in hash table entry ck_ht_entry_value(3) return pointer to value as specified in hash table entry ck_ht_entry_value_direct(3) return value as specified in hash table entry ck_ht_iterator_init(3) initialize hash table iterator

Referred to by

ck_ht_gc(3) perform maintenance on a hash table ck_ht_hash(3) generate a hash value for a hash table ck_ht_init(3) initialize a hash table ck_ht_stat(3) get hash table status ck_ht_count(3) return count of key-value pairs in hash table ck_ht_destroy(3) immediately destroy a hash table ck_ht_get_spmc(3) load a key-value pair from a hash table ck_ht_put_spmc(3) store unique key-value pair into hash table ck_ht_set_spmc(3) store key-value pair into hash table ck_ht_entry_key(3) return pointer to key as specified in hash table entry ck_ht_entry_set(3) initialize a key-value pair ck_ht_grow_spmc(3) resize a hash table if necessary ck_ht_reset_spmc(3) remove all entries from a hash table ck_ht_entry_empty(3) determine whether entry contains a key-value pair ck_ht_entry_value(3) return pointer to value as specified in hash table entry ck_ht_hash_direct(3) generate a hash value for a hash table ck_ht_remove_spmc(3) resize a hash table if necessary ck_ht_entry_key_set(3) initialize pointer to key in hash table entry ck_ht_iterator_init(3) initialize hash table iterator ck_ht_reset_size_spmc(3) remove all entries from a hash table and reset size ck_ht_entry_key_direct(3) return key value as specified in hash table entry ck_ht_entry_key_length(3) returns the length of the key specified in the argument ck_ht_entry_set_direct(3) initialize a key-value pair ck_ht_entry_value_direct(3) return value as specified in hash table entry ck_ht_entry_key_set_direct(3) initialize key value in hash table entry