SimGrid
3.16
Versatile Simulation of Distributed Systems
|
Careful, those functions assume that the key is null-terminated.
Functions | |
void | xbt_dict_set (xbt_dict_t dict, const char *key, void *data, void_f_pvoid_t free_ctn) |
Add data to the dict (null-terminated key) More... | |
void * | xbt_dict_get (xbt_dict_t dict, const char *key) |
Retrieve data from the dict (null-terminated key) More... | |
void * | xbt_dict_get_or_null (xbt_dict_t dict, const char *key) |
like xbt_dict_get(), but returning nullptr when not found More... | |
char * | xbt_dict_get_key (xbt_dict_t dict, const void *data) |
retrieve the key associated to that object. More... | |
char * | xbt_dict_get_elm_key (xbt_dictelm_t elem) |
retrieve the key associated to that xbt_dictelm_t. More... | |
xbt_dictelm_t | xbt_dict_get_elm (xbt_dict_t dict, const char *key) |
Retrieve element from the dict (null-terminated key) More... | |
xbt_dictelm_t | xbt_dict_get_elm_or_null (xbt_dict_t dict, const char *key) |
like xbt_dict_get_elm(), but returning nullptr when not found More... | |
void | xbt_dict_remove (xbt_dict_t dict, const char *key) |
Remove data from the dict (null-terminated key) More... | |
void | xbt_dict_reset (xbt_dict_t dict) |
Remove all data from the dict. More... | |
int | xbt_dict_length (xbt_dict_t dict) |
Return the number of elements in the dict. More... | |
void | xbt_dict_dump_output_string (void *s) |
function to be used in xbt_dict_dump as long as the stored values are strings More... | |
void | xbt_dict_dump (xbt_dict_t dict, void(*output)(void *)) |
Outputs the content of the structure (debugging purpose) More... | |
void | xbt_dict_dump_sizes (xbt_dict_t dict) |
shows some debugging info about the bucklet repartition More... | |
int | xbt_dict_is_empty (xbt_dict_t dict) |
test if the dict is empty or not More... | |
void xbt_dict_set | ( | xbt_dict_t | dict, |
const char * | key, | ||
void * | data, | ||
void_f_pvoid_t | free_ctn | ||
) |
Add data to the dict (null-terminated key)
dict | the dict |
key | the key to set the new data |
data | the data to add in the dict |
free_ctn | function to call with (data as argument) when data is removed from the dictionary. This param will only be considered when the dict was instantiated with xbt_dict_new() and not xbt_dict_new_homogeneous() |
set the data in the structure under the key, which is anull terminated string.
void* xbt_dict_get | ( | xbt_dict_t | dict, |
const char * | key | ||
) |
Retrieve data from the dict (null-terminated key)
dict | the dealer of data |
key | the key to find data |
Search the given key. Throws not_found_error when not found. Check xbt_dict_get_or_null() for a version returning nullptr without exception when not found.
void* xbt_dict_get_or_null | ( | xbt_dict_t | dict, |
const char * | key | ||
) |
like xbt_dict_get(), but returning nullptr when not found
char* xbt_dict_get_key | ( | xbt_dict_t | dict, |
const void * | data | ||
) |
retrieve the key associated to that object.
Warning, that's a linear search
Returns nullptr if the object cannot be found
char* xbt_dict_get_elm_key | ( | xbt_dictelm_t | elm | ) |
retrieve the key associated to that xbt_dictelm_t.
xbt_dictelm_t xbt_dict_get_elm | ( | xbt_dict_t | dict, |
const char * | key | ||
) |
Retrieve element from the dict (null-terminated key)
dict | the dealer of data |
key | the key to find data |
Search the given key. Throws not_found_error when not found. Check xbt_dict_get_or_null() for a version returning nullptr without exception when not found.
xbt_dictelm_t xbt_dict_get_elm_or_null | ( | xbt_dict_t | dict, |
const char * | key | ||
) |
like xbt_dict_get_elm(), but returning nullptr when not found
void xbt_dict_remove | ( | xbt_dict_t | dict, |
const char * | key | ||
) |
Remove data from the dict (null-terminated key)
dict | the dict |
key | the key of the data to be removed |
Remove the entry associated with the given key
void xbt_dict_reset | ( | xbt_dict_t | dict | ) |
Remove all data from the dict.
int xbt_dict_length | ( | xbt_dict_t | dict | ) |
Return the number of elements in the dict.
dict | a dictionary |
function to be used in xbt_dict_dump as long as the stored values are strings
void xbt_dict_dump | ( | xbt_dict_t | dict, |
void_f_pvoid_t | output | ||
) |
Outputs the content of the structure (debugging purpose)
dict | the exibitionist |
output | a function to dump each data in the tree (check xbt_dict_dump_output_string) |
Outputs the content of the structure. (for debugging purpose). output is a function to output the data. If nullptr, data won't be displayed.
void xbt_dict_dump_sizes | ( | xbt_dict_t | dict | ) |
shows some debugging info about the bucklet repartition
int xbt_dict_is_empty | ( | xbt_dict_t | dict | ) |
test if the dict is empty or not