---
name: "ck_ht_next"
section: "3"
platform: "linux"
package: "libck-dev"
version: "0.7.2-6"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ck_ht_next"
---

# ck\_ht\_next(3)

iterate to next entry in hash table

## NAME

**ck\_ht\_next** – iterate to next entry in hash table

## LIBRARY

Concurrency Kit (libck, -lck)

## SYNOPSIS

**#include \<ck\_ht.h\>**

*bool*\

**ck\_ht\_next**(*ck\_ht\_t \*ht*, *ck\_ht\_iterator\_t \*iterator*, *ck\_ht\_entry\_t \*\*entry*);

## DESCRIPTION

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)](/ck_ht_iterator_init/3.md) 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.

## SEE ALSO

[ck\_ht\_stat(3)](/ck_ht_stat/3.md), [ck\_ht\_init(3)](/ck_ht_init/3.md), [ck\_ht\_destroy(3)](/ck_ht_destroy/3.md), [ck\_ht\_hash(3)](/ck_ht_hash/3.md), [ck\_ht\_hash\_direct(3)](/ck_ht_hash_direct/3.md), [ck\_ht\_set\_spmc(3)](/ck_ht_set_spmc/3.md), [ck\_ht\_put\_spmc(3)](/ck_ht_put_spmc/3.md), [ck\_ht\_gc(3)](/ck_ht_gc/3.md), [ck\_ht\_get\_spmc(3)](/ck_ht_get_spmc/3.md), [ck\_ht\_grow\_spmc(3)](/ck_ht_grow_spmc/3.md), [ck\_ht\_remove\_spmc(3)](/ck_ht_remove_spmc/3.md), [ck\_ht\_count(3)](/ck_ht_count/3.md), [ck\_ht\_reset\_spmc(3)](/ck_ht_reset_spmc/3.md), [ck\_ht\_reset\_size\_spmc(3)](/ck_ht_reset_size_spmc/3.md), [ck\_ht\_entry\_empty(3)](/ck_ht_entry_empty/3.md), [ck\_ht\_entry\_key\_set(3)](/ck_ht_entry_key_set/3.md), [ck\_ht\_entry\_key\_set\_direct(3)](/ck_ht_entry_key_set_direct/3.md), [ck\_ht\_entry\_key\_length(3)](/ck_ht_entry_key_length/3.md), [ck\_ht\_entry\_key(3)](/ck_ht_entry_key/3.md), [ck\_ht\_entry\_set(3)](/ck_ht_entry_set/3.md), [ck\_ht\_entry\_set\_direct(3)](/ck_ht_entry_set_direct/3.md), [ck\_ht\_entry\_key\_direct(3)](/ck_ht_entry_key_direct/3.md), [ck\_ht\_entry\_value(3)](/ck_ht_entry_value/3.md), [ck\_ht\_entry\_value\_direct(3)](/ck_ht_entry_value_direct/3.md), [ck\_ht\_iterator\_init(3)](/ck_ht_iterator_init/3.md)

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