- Main Page @@ -69,26 +68,18 @@ Macros
- Deprecated:
- Don't use this outside of linkhash.h:
- Deprecated:
- Don't use this outside of linkhash.h:
- Returns
- 0 - ok, -1 if parameter was invalid
- Returns
- 0 - ok, -1 if parameter was invalid
- See Also
- lh_entry_k_is_constant()
- See Also
- lh_table_insert_w_hash()
- See Also
- lh_table_head() +
- +lh_entry_prev()
- See Also
- lh_table_head() +
- +lh_entry_next()
- Parameters
-
-
msg Message format string, like for printf.... Format args. t the table (used to obtain hash function) k a pointer to the key to lookup - Deprecated:
- Since it is not a good idea to exit the entire program because of an internal library failure, json-c will no longer use this function internally. However, because its interface is public, it will remain part of the API on the off chance of legacy software using it externally.
- Returns
- the key's hash
- Parameters
-
@@ -494,6 +633,9 @@ Functions
- -+
+
+ +
+struct lh_table* lh_kptr_table_new @@ -513,6 +655,11 @@ Functions+read +Convenience function to create a new linkhash table with ptr keys.
- Parameters
- @@ -550,7 +697,8 @@ Functions
Delete a record from the table.
-If a callback free function is provided then it is called for the for the item being deleted.
- Parameters
-
+
If a callback free function is provided then it is called for the for the item being deleted.
+- Parameters
-
t the table to delete from. k a pointer to the key to delete.
Delete a record from the table.
-If a callback free function is provided then it is called for the for the item being deleted.
- Parameters
-
+
If a callback free function is provided then it is called for the for the item being deleted.
+
Insert a record into the table using a precalculated key hash.
-The hash h, which should be calculated with lh_get_hash() on k, is provided by the caller, to allow for optimization when multiple operations with the same key are known to be needed.
+The hash h, which should be calculated with lh_get_hash() on k, is provided by the caller, to allow for optimization when multiple operations with the same key are known to be needed.
- Parameters
-
t the table to insert into. k a pointer to the key to insert. v a pointer to the value to insert. h hash value of the key to insert opts if set to JSON_C_OBJECT_KEY_IS_CONSTANT, sets lh_entry.k_is_constant so t's free function knows to avoid freeing the key. opts if set to JSON_C_OBJECT_ADD_CONSTANT_KEY, sets lh_entry.k_is_constant so t's free function knows to avoid freeing the key.
- -----
-- -const void* lh_table_lookup -( -struct lh_table * -t, -- -- - const void * -k -- -- ) -- -Lookup a record into the table.
-- Parameters
-
-
-
-t the table to lookup k a pointer to the key to lookup
-
- Returns
- a pointer to the found value or NULL if it does not exist.
- Deprecated:
- Use lh_table_lookup_ex() instead.
Return the number of entries in the table.
++
+ +
+struct lh_entry* lh_table_lookup_entry @@ -796,6 +941,11 @@ Functions+read +Lookup a record in the table.
- Parameters
-
@@ -812,6 +962,9 @@ Functions
+
+
+ +
+struct lh_entry* lh_table_lookup_entry_w_hash @@ -837,9 +990,14 @@ Functions+read +Lookup a record in the table using a precalculated key hash.
-The hash h, which should be calculated with lh_get_hash() on k, is provided by the caller, to allow for optimization when multiple operations with the same key are known to be needed.
+The hash h, which should be calculated with lh_get_hash() on k, is provided by the caller, to allow for optimization when multiple operations with the same key are known to be needed.
- Parameters
-
t the table to lookup - json_bool lh_table_lookup_ex +json_bool lh_table_lookup_ex ( struct lh_table * t, @@ -897,6 +1055,9 @@ Functions++
+ +
+struct lh_table* lh_table_new @@ -928,6 +1089,11 @@ Functions+read +Create a new linkhash table.
- Parameters
- @@ -981,9 +1147,9 @@ Functions
-Generated on Mon Mar 5 2018 23:17:09 for json-c by +Generated on Sat Aug 12 2023 18:59:55 for json-c by
- 1.8.8
+ 1.8.2
Typedefs | |
| struct lh_entry * | lh_table_lookup_entry_w_hash (struct lh_table *t, const void *k, const unsigned long h) |
| const void * | lh_table_lookup (struct lh_table *t, const void *k) |
| json_bool | lh_table_lookup_ex (struct lh_table *t, const void *k, void **v) |
| json_bool | lh_table_lookup_ex (struct lh_table *t, const void *k, void **v) |
| int | lh_table_delete_entry (struct lh_table *t, struct lh_entry *e) |
| int | lh_table_length (struct lh_table *t) |
| void | lh_abort (const char *msg,...) |
| int | lh_table_resize (struct lh_table *t, int new_size) |
| static struct lh_entry * | lh_table_head (const lh_table *t) |
| static unsigned long | lh_get_hash (const struct lh_table *t, const void *k) |
| static void * | lh_entry_k (const struct lh_entry *e) |
| static int | lh_entry_k_is_constant (const struct lh_entry *e) |
| static void * | lh_entry_v (const struct lh_entry *e) |
| static void | lh_entry_set_val (struct lh_entry *e, void *newval) |
| static struct lh_entry * | lh_entry_next (const struct lh_entry *e) |
| static struct lh_entry * | lh_entry_prev (const struct lh_entry *e) |
Detailed Description
Internal methods for working with json_type_object objects. Although this is exposed by the json_object_get_object() function and within the json_object_iter type, it is not recommended for direct use.
Macro Definition Documentation
- -| #define _LH_INLINE inline | -
| #define _LH_UNCONST | -( | -- | a | ) | -((void *)(uintptr_t)(const void *)(a)) | -
| #define LH_EMPTY (void*)-1 | +#define LH_EMPTY (void *)-1 |
| #define lh_entry_k | -( | -- | entry | ) | -_LH_UNCONST((entry)->k) | -
Return a non-const version of lh_entry.k.
-lh_entry.k is const to indicate and help ensure that linkhash itself doesn't modify it, but callers are allowed to do what they want with it. See also lh_entry.k_is_constant
- -| #define lh_entry_v | -( | -- | entry | ) | -_LH_UNCONST((entry)->v) | -
Return a non-const version of lh_entry.v.
-v is const to indicate and help ensure that linkhash itself doesn't modify it, but callers are allowed to do what they want with it.
- -| #define LH_FREED (void*)-2 | +#define LH_FREED (void *)-2 |
This function sets the hash function to be used for strings. Must be one of the JSON_C_STR_HASH_* values.
This function sets the hash function to be used for strings. Must be one of the JSON_C_STR_HASH_* values.
+
+
|
+ +inlinestatic | +
Return a non-const version of lh_entry.k.
+lh_entry.k is const to indicate and help ensure that linkhash itself doesn't modify it, but callers are allowed to do what they want with it.
+References lh_entry::k.
+ +
+
|
+ +inlinestatic | +
Returns 1 if the key for the given entry is constant, and thus does not need to be freed when the lh_entry is freed.
+References lh_entry::k_is_constant.
+ +
+
|
+ +staticread | +
Return the next element, or NULL if there is no next element.
+References lh_entry::next.
+ +
+
|
+ +staticread | +
Return the previous element, or NULL if there is no previous element.
+References lh_entry::prev.
+ +
+
|
+ +inlinestatic | +
Change the value for an entry. The caller is responsible for freeing the previous value.
+ +References lh_entry::v.
|
+ +inlinestatic | +
Return a non-const version of lh_entry.v.
+v is const to indicate and help ensure that linkhash itself doesn't modify it, but callers are allowed to do what they want with it.
+ +References lh_entry::v.
+ +
+
|
+ +inlinestatic | +
Prints a message to stdout, then exits the program with an exit code of 1.
Calculate the hash of a key for a given table.
+This is an extension to support functions that need to calculate the hash several times and allows them to do it just once and then pass in the hash to all utility functions. Depending on use case, this can be a considerable performance improvement.
References lh_table::hash_fn.
|
+ +read | +
Convenience function to create a new linkhash table with char keys.