GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
CK_HT_GET_SPMC(3) FreeBSD Library Functions Manual CK_HT_GET_SPMC(3)

ck_ht_get_spmc
load a key-value pair from a hash table

Concurrency Kit (libck, -lck)

#include <ck_ht.h>

bool
ck_ht_get_spmc(ck_ht_t *ht, ck_ht_hash_t h, ck_ht_entry_t *entry);

The ck_ht_get_spmc() function will return the value associated with the key specified in the entry argument in the hash table pointed to by the ht argument. The key specified in entry is expected to have the hash value specified by the h argument.

If ht was created with CK_HT_MODE_BYTESTRING then entry must have been initialized with the ck_ht_entry_set_key(3) or ck_ht_entry_set(3) functions. If ht was created with CK_HT_MODE_DIRECT then entry must have been initialized with the ck_ht_entry_key_set_direct(3) or ck_ht_entry_set_direct(3) functions.

It is expected that h was initialized with ck_ht_hash(3) if ht was created with CK_HT_MODE_BYTESTRING. If ht was initialized with CK_HT_MODE_DIRECT then it is expected that h was initialized with the ck_ht_hash_direct(3) function.

If the call to ck_ht_get_spmc() was successful then the key-value pair in entry was successfully found in the hash table pointed to by h and will fail if the key specified in entry does not exist in the hash table. If successful entry will contain the key-value pair found in the hash table pointed to by the ht argument.

If ht was initialized with CK_HT_MODE_BYTESTRING then the key/value pair in entry may be extracted using the ck_ht_entry_key(3) and ck_ht_entry_value(3) functions. The length of the key may be extracted using the ck_ht_entry_key_length(3) function.

If ht was initialized with CK_HT_MODE_DIRECT then the key/value pair in entry may be extracted using the ck_ht_entry_key_direct(3) and ck_ht_entry_value_direct(3) functions.

This function is safe to call in the presence of a concurrent writer.

Upon successful completion ck_ht_get_spmc() returns true. If successful, entry will contain the key/value pair as found in the hash table. Otherwise the function returns false on failure.

Behavior is undefined if entry or ht are uninitialized. The function will return false if the key as specified in entry was not found in the hash table.

ck_ht_stat(3), ck_ht_init(3), ck_ht_destroy(3), ck_ht_hash(3), ck_ht_hash_direct(3), ck_ht_set_spmc(3), ck_ht_put_spmc(3), ck_ht_gc(3), ck_ht_grow_spmc(3), ck_ht_remove_spmc(3), ck_ht_reset_spmc(3), ck_ht_reset_size_spmc(3), ck_ht_count(3), ck_ht_entry_empty(3), ck_ht_entry_key_set(3), ck_ht_entry_key_set_direct(3), ck_ht_entry_key(3), ck_ht_entry_key_length(3), ck_ht_entry_value(3), ck_ht_entry_set(3), ck_ht_entry_set_direct(3), ck_ht_entry_key_direct(3), ck_ht_entry_value_direct(3), ck_ht_iterator_init(3), ck_ht_next(3)

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

March 29, 2012

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.