Collaboration diagram for Hash Functions:

Macros
#define	switch_core_hash_init(_hash) switch_core_hash_init_case(_hash, SWITCH_TRUE)

#define	switch_core_hash_init_nocase(_hash) switch_core_hash_init_case(_hash, SWITCH_FALSE)

#define	switch_core_hash_insert(_h, _k, _d) switch_core_hash_insert_destructor(_h, _k, _d, NULL)

#define	switch_core_hash_first(_h) switch_core_hash_first_iter(_h, NULL)

Functions
switch_status_t	switch_core_hash_init_case (_Out_ switch_hash_t **hash, switch_bool_t case_sensitive)
	Initialize a hash table. More...

switch_status_t	switch_core_hash_destroy (_Inout_ switch_hash_t **hash)
	Destroy an existing hash table. More...

switch_status_t	switch_core_hash_insert_destructor (_In_ switch_hash_t hash, _In_z_ const char key, _In_opt_ const void *data, hashtable_destructor_t destructor)
	Insert data into a hash. More...

switch_status_t	switch_core_hash_insert_locked (_In_ switch_hash_t hash, _In_z_ const char key, _In_opt_ const void data, _In_opt_ switch_mutex_t mutex)
	Insert data into a hash. More...

switch_status_t	switch_core_hash_insert_wrlock (switch_hash_t hash, const char key, const void data, switch_thread_rwlock_t rwlock)
	Retrieve data from a given hash. More...

void *	switch_core_hash_delete (_In_ switch_hash_t hash, _In_z_ const char key)
	Delete data from a hash based on desired key. More...

void *	switch_core_hash_delete_locked (_In_ switch_hash_t hash, _In_z_ const char key, _In_opt_ switch_mutex_t *mutex)
	Delete data from a hash based on desired key. More...

void *	switch_core_hash_delete_wrlock (_In_ switch_hash_t hash, _In_z_ const char key, _In_opt_ switch_thread_rwlock_t *rwlock)
	Delete data from a hash based on desired key. More...

switch_status_t	switch_core_hash_delete_multi (_In_ switch_hash_t hash, _In_ switch_hash_delete_callback_t callback, _In_opt_ void pData)
	Delete data from a hash based on callback function. More...

void *	switch_core_hash_find (_In_ switch_hash_t hash, _In_z_ const char key)
	Retrieve data from a given hash. More...

void *	switch_core_hash_find_locked (_In_ switch_hash_t hash, _In_z_ const char key, _In_ switch_mutex_t *mutex)
	Retrieve data from a given hash. More...

void *	switch_core_hash_find_rdlock (_In_ switch_hash_t hash, _In_z_ const char key, _In_ switch_thread_rwlock_t *rwlock)
	Retrieve data from a given hash. More...

switch_hash_index_t *	switch_core_hash_first_iter (_In_ switch_hash_t hash, switch_hash_index_t hi)
	Gets the first element of a hashtable. More...

switch_bool_t	switch_core_hash_empty (switch_hash_t *hash)
	tells if a hash is empty More...

switch_hash_index_t *	switch_core_hash_next (_In_ switch_hash_index_t **hi)
	Gets the next element of a hashtable. More...

void	switch_core_hash_this (_In_ switch_hash_index_t hi, _Out_opt_ptrdiff_cap_(klen) const void key, _Out_opt_ switch_ssize_t klen, _Out_ void **val)
	Gets the key and value of the current hash element. More...

void	switch_core_hash_this_val (switch_hash_index_t hi, void val)

switch_status_t	switch_core_inthash_init (switch_inthash_t **hash)

switch_status_t	switch_core_inthash_destroy (switch_inthash_t **hash)

switch_status_t	switch_core_inthash_insert (switch_inthash_t hash, uint32_t key, const void data)

void *	switch_core_inthash_delete (switch_inthash_t *hash, uint32_t key)

void *	switch_core_inthash_find (switch_inthash_t *hash, uint32_t key)

Detailed Description

Macro Definition Documentation

#define switch_core_hash_init ( _hash ) switch_core_hash_init_case(_hash, SWITCH_TRUE)

Definition at line 1390 of file switch_core.h.

Referenced by switch_channel_alloc(), switch_channel_global_init(), switch_channel_set_app_flag_key(), switch_console_init(), switch_core_session_init(), switch_event_init(), switch_ivr_digit_stream_parser_new(), switch_ivr_dmachine_create(), switch_live_array_create(), switch_load_network_lists(), switch_load_timezones(), switch_loadable_module_init(), switch_rtp_init(), and switch_xml_init().

#define switch_core_hash_init_nocase ( _hash ) switch_core_hash_init_case(_hash, SWITCH_FALSE)

Definition at line 1391 of file switch_core.h.

Referenced by switch_loadable_module_init().

#define switch_core_hash_insert	(	_h,
		_k,
		_d
	)	switch_core_hash_insert_destructor(_h, _k, _d, NULL)

Definition at line 1410 of file switch_core.h.

Referenced by switch_channel_set_app_flag_key(), switch_channel_set_device_id(), switch_console_add_complete_func(), switch_console_del_complete_func(), switch_core_hash_insert_locked(), switch_core_hash_insert_wrlock(), switch_core_mime_add_type(), switch_core_register_secondary_recover_callback(), switch_core_session_request_uuid(), switch_core_session_set_uuid(), switch_event_channel_permission_modify(), switch_event_channel_sub_channel(), switch_event_reserve_subclass_detailed(), switch_ivr_digit_stream_parser_set_event(), switch_ivr_dmachine_bind(), switch_live_array_add(), switch_live_array_add_alias(), switch_live_array_create(), switch_load_core_config(), switch_load_network_lists(), switch_load_timezones(), switch_loadable_module_process(), switch_loadable_module_unprocess(), switch_rtp_request_port(), and switch_xml_user_cache().

Function Documentation

void* switch_core_hash_delete	(	_In_ switch_hash_t *	hash,
		_In_z_ const char *	key
	)

Delete data from a hash based on desired key.

Parameters

hash	the hash to delete from
key	the key from which to delete the data

Returns: The value stored if the data is deleted otherwise NULL

Referenced by process_device_hup(), switch_core_session_perform_destroy(), switch_core_session_set_uuid(), switch_core_unregister_secondary_recover_callback(), switch_event_channel_permission_clear(), switch_event_free_subclass_detailed(), switch_ivr_digit_stream_parser_del_event(), switch_ivr_dmachine_clear_realm(), switch_live_array_clear_alias(), switch_live_array_del(), switch_live_array_destroy(), switch_loadable_module_unload_module(), switch_loadable_module_unprocess(), switch_xml_clear_user_cache(), switch_xml_user_cache(), and unsub_all_switch_event_channel().

void* switch_core_hash_delete_locked	(	_In_ switch_hash_t *	hash,
		_In_z_ const char *	key,
		_In_opt_ switch_mutex_t *	mutex
	)

Delete data from a hash based on desired key.

Parameters

hash	the hash to delete from
key	the key from which to delete the data
mutex	optional mutex to lock

Returns: a pointer to the deleted data

switch_status_t switch_core_hash_delete_multi	(	_In_ switch_hash_t *	hash,
		_In_ switch_hash_delete_callback_t	callback,
		_In_opt_ void *	pData
	)

Delete data from a hash based on callback function.

Parameters

hash	the hash to delete from
callback	the function to call which returns SWITCH_TRUE to delete, SWITCH_FALSE to preserve

Returns: SWITCH_STATUS_SUCCESS if any data is deleted

void* switch_core_hash_delete_wrlock	(	_In_ switch_hash_t *	hash,
		_In_z_ const char *	key,
		_In_opt_ switch_thread_rwlock_t *	rwlock
	)

Delete data from a hash based on desired key.

Parameters

hash	the hash to delete from
key	the key from which to delete the data
mutex	optional rwlock to wrlock

Returns: a pointer to the deleted data

switch_status_t switch_core_hash_destroy ( _Inout_ switch_hash_t ** hash )

Destroy an existing hash table.

Parameters

hash	the hash to destroy

Returns: SWITCH_STATUS_SUCCESS if the hash is destroyed

Referenced by switch_channel_global_uninit(), switch_channel_uninit(), switch_console_shutdown(), switch_core_destroy(), switch_core_session_uninit(), switch_event_shutdown(), switch_ivr_digit_stream_parser_destroy(), switch_ivr_dmachine_destroy(), switch_live_array_destroy(), switch_load_network_lists(), switch_load_timezones(), switch_loadable_module_shutdown(), SWITCH_MODULE_SHUTDOWN_FUNCTION(), switch_rtp_shutdown(), and switch_xml_destroy().

switch_bool_t switch_core_hash_empty ( switch_hash_t * hash )

tells if a hash is empty

Parameters

hash	the hashtable

Returns: TRUE or FALSE depending on if the hash is empty

Definition at line 216 of file switch_core_hash.c.

References switch_core_hash_first, SWITCH_FALSE, switch_safe_free, and SWITCH_TRUE.

 {
         switch_hash_index_t *hi = switch_core_hash_first(hash);
 
         if (hi) {
                 switch_safe_free(hi);
                 return SWITCH_FALSE;
         }
 
         return SWITCH_TRUE;
 
 }

void* switch_core_hash_find	(	_In_ switch_hash_t *	hash,
		_In_z_ const char *	key
	)

Retrieve data from a given hash.

Parameters

hash	the hash to retrieve from
key	the key to retrieve

Returns: a pointer to the data held in the key

Referenced by _switch_event_channel_broadcast(), switch_channel_clear_app_flag_key(), switch_channel_set_app_flag_key(), switch_channel_set_device_id(), switch_channel_test_app_flag_key(), switch_check_network_list_ip_token(), switch_console_run_complete_func(), switch_core_get_secondary_recover_callback(), switch_core_mime_add_type(), switch_core_mime_ext2type(), switch_core_mime_type2ext(), switch_core_register_secondary_recover_callback(), switch_core_session_event_send(), switch_core_session_message_send(), switch_core_session_perform_force_locate(), switch_core_session_perform_locate(), switch_core_session_request_uuid(), switch_core_session_set_uuid(), switch_default_ptime(), switch_event_bind_removable(), switch_event_build_param_string(), switch_event_channel_permission_clear(), switch_event_channel_permission_modify(), switch_event_channel_permission_verify(), switch_event_channel_sub_channel(), switch_event_channel_unsub_channel(), switch_event_free_subclass_detailed(), switch_event_reserve_subclass_detailed(), switch_ivr_digit_stream_parser_feed(), switch_ivr_dmachine_bind(), switch_ivr_dmachine_clear_realm(), switch_ivr_dmachine_set_realm(), switch_live_array_add(), switch_live_array_create(), switch_live_array_del(), switch_live_array_get(), switch_loadable_module_exists(), switch_loadable_module_get_codec_interface(), switch_loadable_module_get_endpoint_interface(), switch_loadable_module_get_file_interface(), switch_loadable_module_process(), switch_loadable_module_unload_module(), switch_loadable_module_unprocess(), switch_lookup_timezone(), switch_rtp_release_port(), switch_rtp_request_port(), switch_xml_clear_user_cache(), switch_xml_locate_user_cache(), and switch_xml_user_cache().

void* switch_core_hash_find_locked	(	_In_ switch_hash_t *	hash,
		_In_z_ const char *	key,
		_In_ switch_mutex_t *	mutex
	)

Retrieve data from a given hash.

Parameters

hash	the hash to retrieve from
key	the key to retrieve
mutex	optional mutex to lock

Returns: a pointer to the data held in the key

Referenced by switch_channel_get_private(), switch_channel_get_private_partner(), switch_loadable_module_get_management_interface(), switch_loadable_module_get_say_interface(), and switch_loadable_module_load_module_ex().

void* switch_core_hash_find_rdlock	(	_In_ switch_hash_t *	hash,
		_In_z_ const char *	key,
		_In_ switch_thread_rwlock_t *	rwlock
	)

Retrieve data from a given hash.

Parameters

hash	the hash to retrieve from
key	the key to retrieve
mutex	optional rwlock to rdlock

Returns: a pointer to the data held in the key

switch_hash_index_t* switch_core_hash_first_iter	(	_In_ switch_hash_t *	hash,
		switch_hash_index_t *	hi
	)

Gets the first element of a hashtable.

Parameters

deprecate_me	[deprecated] NULL
hash	the hashtable to use

Returns: The element, or NULL if it wasn't found

Referenced by switch_xml_clear_user_cache(), and unsub_all_switch_event_channel().

switch_status_t switch_core_hash_init_case	(	_Out_ switch_hash_t **	hash,
		switch_bool_t	case_sensitive
	)

Initialize a hash table.

Parameters

hash	a NULL pointer to a hash table to aim at the new hash
pool	the pool to use for the new hash

Returns: SWITCH_STATUS_SUCCESS if the hash is created

Referenced by switch_core_init().

switch_status_t switch_core_hash_insert_destructor	(	_In_ switch_hash_t *	hash,
		_In_z_ const char *	key,
		_In_opt_ const void *	data,
		hashtable_destructor_t	destructor
	)

Insert data into a hash.

Parameters

hash	the hash to add data to
key	the name of the key to add the data to
data	the data to add

Returns: SWITCH_STATUS_SUCCESS if the data is added

Note: the string key must be a constant or a dynamic string

switch_status_t switch_core_hash_insert_locked	(	_In_ switch_hash_t *	hash,
		_In_z_ const char *	key,
		_In_opt_ const void *	data,
		_In_opt_ switch_mutex_t *	mutex
	)

Insert data into a hash.

Parameters

hash	the hash to add data to
key	the name of the key to add the data to
data	the data to add
mutex	optional mutex to lock

Returns: SWITCH_STATUS_SUCCESS if the data is added

Note: the string key must be a constant or a dynamic string

Referenced by switch_channel_set_private(), and switch_loadable_module_unload_module().

switch_status_t switch_core_hash_insert_wrlock	(	switch_hash_t *	hash,
		const char *	key,
		const void *	data,
		switch_thread_rwlock_t *	rwlock
	)

Retrieve data from a given hash.

Parameters

hash	the hash to retrieve from
key	the key to retrieve
mutex	optional rwlock to wrlock

Returns: a pointer to the data held in the key

Definition at line 84 of file switch_core_hash.c.

References switch_core_hash_insert, SWITCH_STATUS_FALSE, switch_thread_rwlock_unlock(), and switch_thread_rwlock_wrlock().

 {
         switch_status_t status = SWITCH_STATUS_FALSE;
 
         if (rwlock) {
                 switch_thread_rwlock_wrlock(rwlock);
         }
 
         status = switch_core_hash_insert(hash, key, data);
 
         if (rwlock) {
                 switch_thread_rwlock_unlock(rwlock);
         }
 
         return status;
 }

switch_hash_index_t* switch_core_hash_next ( _In_ switch_hash_index_t ** hi )

Gets the next element of a hashtable.

Parameters

hi	The current element

Returns: The next element, or NULL if there are no more

Referenced by do_chat_send(), switch_core_session_findall(), switch_core_session_findall_matching_var(), switch_core_session_hupall(), switch_core_session_hupall_endpoint(), switch_core_session_hupall_matching_var_ans(), switch_event_channel_unsub_channel(), switch_event_get_custom_events(), switch_event_shutdown(), switch_jb_pop_nack(), switch_loadable_module_enumerate_loaded(), switch_loadable_module_get_codecs(), switch_loadable_module_runtime(), switch_loadable_module_shutdown(), and switch_rtp_shutdown().

void switch_core_hash_this	(	_In_ switch_hash_index_t *	hi,
		_Out_opt_ptrdiff_cap_(klen) const void **	key,
		_Out_opt_ switch_ssize_t *	klen,
		_Out_ void **	val
	)

Gets the key and value of the current hash element.

Parameters

hi	The current element
key	[out] the key
klen	[out] the key's size
val	[out] the value

Referenced by do_chat_send(), switch_core_session_findall(), switch_core_session_findall_matching_var(), switch_core_session_hupall(), switch_core_session_hupall_endpoint(), switch_core_session_hupall_matching_var_ans(), switch_event_channel_unsub_channel(), switch_event_get_custom_events(), switch_event_shutdown(), switch_jb_pop_nack(), switch_loadable_module_enumerate_loaded(), switch_loadable_module_get_codecs(), switch_loadable_module_runtime(), switch_loadable_module_shutdown(), switch_rtp_shutdown(), switch_xml_clear_user_cache(), and unsub_all_switch_event_channel().

void switch_core_hash_this_val	(	switch_hash_index_t *	hi,
		void *	val
	)

Definition at line 244 of file switch_core_hash.c.

References switch_hashtable_this_val().

 {
         switch_hashtable_this_val(hi, val);
 }

void* switch_core_inthash_delete	(	switch_inthash_t *	hash,
		uint32_t	key
	)

Definition at line 274 of file switch_core_hash.c.

References switch_hashtable_remove().

Referenced by hide_node(), switch_jb_pop_nack(), and switch_jb_put_packet().

 {
         return switch_hashtable_remove(hash, (void *)&key);
 }

switch_status_t switch_core_inthash_destroy ( switch_inthash_t ** hash )

Definition at line 255 of file switch_core_hash.c.

References switch_hashtable_destroy(), and SWITCH_STATUS_SUCCESS.

Referenced by switch_jb_destroy(), and switch_jb_reset().

 {
         switch_hashtable_destroy(hash);
 
         return SWITCH_STATUS_SUCCESS;
 }

void* switch_core_inthash_find	(	switch_inthash_t *	hash,
		uint32_t	key
	)

Definition at line 279 of file switch_core_hash.c.

References switch_hashtable_search().

Referenced by jb_next_packet_by_seq(), jb_next_packet_by_ts(), switch_jb_get_packet_by_seq(), and switch_jb_peek_frame().

 {
         return switch_hashtable_search(hash, (void *)&key);
 }

switch_status_t switch_core_inthash_init ( switch_inthash_t ** hash )

Definition at line 250 of file switch_core_hash.c.

References switch_create_hashtable(), switch_hash_default_int(), and switch_hash_equalkeys_int().

Referenced by switch_jb_create(), switch_jb_reset(), and switch_jb_ts_mode().

 {
         return switch_create_hashtable(hash, 16, switch_hash_default_int, switch_hash_equalkeys_int);
 }

switch_status_t switch_core_inthash_insert	(	switch_inthash_t *	hash,
		uint32_t	key,
		const void *	data
	)

Definition at line 262 of file switch_core_hash.c.

References HASHTABLE_DUP_CHECK, HASHTABLE_FLAG_FREE_KEY, switch_hashtable_insert_destructor(), SWITCH_STATUS_FALSE, SWITCH_STATUS_SUCCESS, and switch_zmalloc.

Referenced by add_node(), switch_jb_pop_nack(), and switch_jb_put_packet().

 {
         uint32_t *k = NULL;
         int r = 0;
 
         switch_zmalloc(k, sizeof(*k));
         *k = key;
         r = switch_hashtable_insert_destructor(hash, k, (void *)data, HASHTABLE_FLAG_FREE_KEY | HASHTABLE_DUP_CHECK, NULL);
 
         return r ? SWITCH_STATUS_SUCCESS : SWITCH_STATUS_FALSE;
 }

Macros

Functions

Detailed Description

Macro Definition Documentation

Function Documentation