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: