DragonFly On-Line Manual Pages

Search: Section:  


CK_RHS_MOVE(3)        DragonFly Library Functions Manual        CK_RHS_MOVE(3)

NAME

ck_rhs_move - move one from hash set to another

LIBRARY

Concurrency Kit (libck, -lck)

SYNOPSIS

#include <ck_rhs.h> bool ck_rhs_move(ck_rhs_t *destination, ck_rhs_t *source, ck_rhs_hash_cb_t *hash_cb, ck_rhs_compare_cb_t *compare_cb, struct ck_malloc *m);

DESCRIPTION

The ck_rhs_move(3) function will initialize source from destination. The hash function is set to hash_cb, comparison function to compare_cb and the allocator callbacks to m. Further modifications to source will result in undefined behavior. Concurrent ck_rhs_get(3) and ck_rhs_fas(3) operations to source are legal until the next write operation to destination. This operation moves ownership from one hash set object to another and re-assigns callback functions to developer-specified values. This allows for dynamic configuration of allocation callbacks and is necessary for use-cases involving executable code which may be unmapped underneath the hash set.

RETURN VALUES

Upon successful completion ck_rhs_move(3) returns true and otherwise returns false to indicate an error.

SEE ALSO

ck_rhs_init(3), ck_rhs_destroy(3), CK_RHS_HASH(3), ck_rhs_iterator_init(3), ck_rhs_next(3), ck_rhs_put(3), ck_rhs_put_unique(3), ck_rhs_set(3), ck_rhs_fas(3), ck_rhs_remove(3), ck_rhs_grow(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/ July 18, 2013

Search: Section: