| libwget-stringmap(3) | wget2 | libwget-stringmap(3) |
libwget-stringmap - Stringmap functions
wget_stringmap_t * wget_stringmap_create (int max)
wget_stringmap_t * wget_stringmap_create_nocase (int max)
int wget_stringmap_put_noalloc (wget_stringmap_t *h, const char *key,
const void *value)
int wget_stringmap_put (wget_stringmap_t *h, const char *key, const
void *value, size_t valuesize)
int wget_stringmap_get_null (const wget_stringmap_t *h, const char
*key, void **value)
void * wget_stringmap_get (const wget_stringmap_t *h, const char *key)
int wget_stringmap_contains (const wget_stringmap_t *h, const char
*key)
int wget_stringmap_remove (wget_stringmap_t *h, const char *key)
int wget_stringmap_remove_nofree (wget_stringmap_t *h, const char *key)
void wget_stringmap_free (wget_stringmap_t **h)
void wget_stringmap_clear (wget_stringmap_t *h)
int wget_stringmap_size (const wget_stringmap_t *h)
int wget_stringmap_browse (const wget_stringmap_t *h,
wget_stringmap_browse_t browse, void *ctx)
void wget_stringmap_setcmpfunc (wget_stringmap_t *h,
wget_stringmap_compare_t cmp)
void wget_stringmap_sethashfunc (wget_stringmap_t *h,
wget_stringmap_hash_t hash)
void wget_stringmap_set_key_destructor (wget_hashmap_t *h,
wget_stringmap_key_destructor_t destructor)
void wget_stringmap_set_value_destructor (wget_hashmap_t *h,
wget_stringmap_value_destructor_t destructor)
void wget_stringmap_setloadfactor (wget_stringmap_t *h, float factor)
void wget_stringmap_set_growth_policy (wget_stringmap_t *h, int off)
Stringmaps are key/value stores that perform at O(1) for insertion, searching and removing. The key is a C string.
These functions are a wrapper around the Hashmap API.
Parameters
Returns
Create a new stringmap instance with initial size max. It should be free'd after use with wget_stringmap_free().
The hash function is an efficient string hash algorithm originally researched by Paul Larson.
The compare function is strcmp(). The key strings are compared case-sensitive.
Parameters
Returns
Create a new stringmap instance with initial size max. It should be free'd after use with wget_stringmap_free().
The hash function is an efficient string hash algorithm originally researched by Paul Larson, using lowercase'd keys.
The compare function is strcasecmp() (case-insensitive).
Parameters
Returns
Insert a key/value pair into stringmap h.
key and value are not cloned, the stringmap takes 'ownership' of both.
If key already exists and the pointer values the old and the new key differ, the old key will be destroyed by calling the key destructor function (default is free()).
To realize a hashset (just keys without values), value may be NULL.
Neither h nor key must be NULL.
Parameters
Returns
Insert a key/value pair into stringmap h.
If key already exists it will not be cloned. In this case the value destructor function will be called with the old value and the new value will be shallow cloned.
If doesn't exist, both key and value will be shallow cloned.
To realize a hashset (just keys without values), value may be NULL.
Neither h nor key must be NULL.
Parameters
Returns
Get the value for a given key.
If there are NULL values in the stringmap, you should use this function to distinguish between 'not found' and 'found NULL value'.
Neither h nor key must be NULL.
Parameters
Returns
Get the value for a given key.
If there are NULL values in the stringmap, you should use wget_stringmap_get_null() to distinguish between 'not found' and 'found NULL value'.
Neither h nor key must be NULL.
Parameters
Returns
Check if key exists in h.
Parameters
Returns
Remove key from stringmap h.
If key is found, the key and value destructor functions are called when removing the entry from the stringmap.
Parameters
Returns
Remove key from stringmap h.
Key and value destructor functions are not called when removing the entry from the stringmap.
Parameters
Remove all entries from stringmap h and free the stringmap instance.
Key and value destructor functions are called for each entry in the stringmap.
Parameters
Remove all entries from stringmap h.
Key and value destructor functions are called for each entry in the stringmap.
Parameters
Returns
Return the number of entries in the stringmap h.
Parameters
Returns
Call function browse for each element of stringmap h or until browse returns a value not equal to zero.
browse is called with ctx and the pointer to the current element.
The return value of the last call to browse is returned or 0 if either h or browse is NULL.
Parameters
Set the comparison function.
Parameters
Set the key hash function.
The keys of all entries in the stringmap will be hashed again.
Parameters
Set the key destructor function.
Default is free().
Parameters
Set the value destructor function.
Default is free().
Parameters
Set the load factor function.
The load factor is determines when to resize the internal memory. 0.75 means 'resize if 75% or more of all slots are used'.
The resize strategy is set by wget_stringmap_set_growth_policy().
The resize (and rehashing) occurs earliest on the next insertion of a new key.
Default is 0.75.
Parameters
Set the growth policy for internal memory.
Default is -2.
Generated automatically by Doxygen for wget2 from the source code.
| Tue Jan 26 2021 | Version 1.99.1 |