Dictionaries with non-nul terminated keys

Those functions work even with non-null terminated keys. More...

Classes
struct	s_xbt_dict_cursor

Functions
void	xbt_dict_set_ext (xbt_dict_t dict, const char *key, int key_len, void *data, void_f_pvoid_t free_ctn)
	Add data to the dict (arbitrary key) More...
void *	xbt_dict_get_ext (xbt_dict_t dict, const char *key, int key_len)
	Retrieve data from the dict (arbitrary key) More...
void *	xbt_dict_get_or_null_ext (xbt_dict_t dict, const char *key, int key_len)
	like xbt_dict_get_ext(), but returning NULL when not found More...
void	xbt_dict_remove_ext (xbt_dict_t dict, const char *key, int key_len)
	Remove data from the dict (arbitrary key) More...

Detailed Description

Those functions work even with non-null terminated keys.

Function Documentation

void xbt_dict_set_ext ( xbt_dict_t  dict, const char *  key, int  key_len, void *  data, void_f_pvoid_t  free_ctn  )

inline

Add data to the dict (arbitrary key)

Parameters

dict	the container
key	the key to set the new data
key_len	the size of the key
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 can be any kind of data, as long as its length is provided in key_len.

void* xbt_dict_get_ext ( xbt_dict_t  dict, const char *  key, int  key_len  )

inline

Retrieve data from the dict (arbitrary key)

Parameters

dict	the dealer of data
key	the key to find data
key_len	the size of the key

Returns

the data that we are looking for

Search the given key. Throws not_found_error when not found.

void* xbt_dict_get_or_null_ext	(	xbt_dict_t	dict,
		const char *	key,
		int	key_len
	)

like xbt_dict_get_ext(), but returning NULL when not found

void xbt_dict_remove_ext ( xbt_dict_t  dict, const char *  key, int  key_len  )

inline

Remove data from the dict (arbitrary key)

Parameters

dict	the trash can
key	the key of the data to be removed
key_len	the size of the key

Remove the entry associated with the given key (throws not_found)