diff options
author | Harald Radi <phanto@php.net> | 2002-03-20 21:26:46 +0000 |
---|---|---|
committer | Harald Radi <phanto@php.net> | 2002-03-20 21:26:46 +0000 |
commit | d5e64b2287b1a8c38d29af1597af6d63a0f7e68c (patch) | |
tree | a15421fd90dd99ec7b0a0a2719e524031fe733de /Zend/zend_ts_hash.h | |
parent | 4586665c19f7c7d4b229847de7b6af5eac7ed03f (diff) | |
download | php-git-d5e64b2287b1a8c38d29af1597af6d63a0f7e68c.tar.gz |
added thread safe hashtable which allows concurrent
reads but only exclusive writes
Diffstat (limited to 'Zend/zend_ts_hash.h')
-rw-r--r-- | Zend/zend_ts_hash.h | 115 |
1 files changed, 115 insertions, 0 deletions
diff --git a/Zend/zend_ts_hash.h b/Zend/zend_ts_hash.h new file mode 100644 index 0000000000..51472297df --- /dev/null +++ b/Zend/zend_ts_hash.h @@ -0,0 +1,115 @@ +/* + +----------------------------------------------------------------------+ + | Zend Engine | + +----------------------------------------------------------------------+ + | Copyright (c) 1998-2002 Zend Technologies Ltd. (http://www.zend.com) | + +----------------------------------------------------------------------+ + | This source file is subject to version 2.00 of the Zend license, | + | that is bundled with this package in the file LICENSE, and is | + | available at through the world-wide-web at | + | http://www.zend.com/license/2_00.txt. | + | If you did not receive a copy of the Zend license and are unable to | + | obtain it through the world-wide-web, please send a note to | + | license@zend.com so we can mail you a copy immediately. | + +----------------------------------------------------------------------+ + | Authors: Harald Radi <harald.radi@nme.at> | + +----------------------------------------------------------------------+ +*/ + +#ifndef ZEND_TS_HASH_H +#define ZEND_TS_HASH_H + +#include "zend.h" + +typedef struct _zend_ts_hashtable { + HashTable hash; + zend_uint reader; + MUTEX_T mx_reader; + MUTEX_T mx_writer; +} TsHashTable; + +BEGIN_EXTERN_C() + +/* startup/shutdown */ +ZEND_API int zend_ts_hash_init(TsHashTable *ht, uint nSize, hash_func_t pHashFunction, dtor_func_t pDestructor, int persistent); +ZEND_API int zend_ts_hash_init_ex(TsHashTable *ht, uint nSize, hash_func_t pHashFunction, dtor_func_t pDestructor, int persistent, zend_bool bApplyProtection); +ZEND_API void zend_ts_hash_destroy(TsHashTable *ht); +ZEND_API void zend_ts_hash_clean(TsHashTable *ht); + +/* additions/updates/changes */ +ZEND_API int zend_ts_hash_add_or_update(TsHashTable *ht, char *arKey, uint nKeyLength, void *pData, uint nDataSize, void **pDest, int flag); +#define zend_ts_hash_update(ht, arKey, nKeyLength, pData, nDataSize, pDest) \ + zend_ts_hash_add_or_update(ht, arKey, nKeyLength, pData, nDataSize, pDest, HASH_UPDATE) +#define zend_ts_hash_add(ht, arKey, nKeyLength, pData, nDataSize, pDest) \ + zend_ts_hash_add_or_update(ht, arKey, nKeyLength, pData, nDataSize, pDest, HASH_ADD) + +ZEND_API int zend_ts_hash_quick_add_or_update(TsHashTable *ht, char *arKey, uint nKeyLength, ulong h, void *pData, uint nDataSize, void **pDest, int flag); +#define zend_ts_hash_quick_update(ht, arKey, nKeyLength, h, pData, nDataSize, pDest) \ + zend_ts_hash_quick_add_or_update(ht, arKey, nKeyLength, h, pData, nDataSize, pDest, HASH_UPDATE) +#define zend_ts_hash_quick_add(ht, arKey, nKeyLength, h, pData, nDataSize, pDest) \ + zend_ts_hash_quick_add_or_update(ht, arKey, nKeyLength, h, pData, nDataSize, pDest, HASH_ADD) + +ZEND_API int zend_ts_hash_index_update_or_next_insert(TsHashTable *ht, ulong h, void *pData, uint nDataSize, void **pDest, int flag); +#define zend_ts_hash_index_update(ht, h, pData, nDataSize, pDest) \ + zend_ts_hash_index_update_or_next_insert(ht, h, pData, nDataSize, pDest, HASH_UPDATE) +#define zend_ts_hash_next_index_insert(ht, pData, nDataSize, pDest) \ + zend_ts_hash_index_update_or_next_insert(ht, 0, pData, nDataSize, pDest, HASH_NEXT_INSERT) + +ZEND_API int zend_ts_hash_add_empty_element(TsHashTable *ht, char *arKey, uint nKeyLength); + +ZEND_API void zend_ts_hash_graceful_destroy(TsHashTable *ht); +ZEND_API void zend_ts_hash_apply(TsHashTable *ht, apply_func_t apply_func TSRMLS_DC); +ZEND_API void zend_ts_hash_apply_with_argument(TsHashTable *ht, apply_func_arg_t apply_func, void * TSRMLS_DC); +ZEND_API void zend_ts_hash_apply_with_arguments(TsHashTable *ht, apply_func_args_t apply_func, int, ...); + +ZEND_API void zend_ts_hash_reverse_apply(TsHashTable *ht, apply_func_t apply_func TSRMLS_DC); + + +/* Deletes */ +ZEND_API int zend_ts_hash_del_key_or_index(TsHashTable *ht, char *arKey, uint nKeyLength, ulong h, int flag); +#define zend_ts_hash_del(ht, arKey, nKeyLength) \ + zend_ts_hash_del_key_or_index(ht, arKey, nKeyLength, 0, HASH_DEL_KEY) +#define zend_ts_hash_index_del(ht, h) \ + zend_ts_hash_del_key_or_index(ht, NULL, 0, h, HASH_DEL_INDEX) + +ZEND_API ulong zend_ts_get_hash_value(TsHashTable *ht, char *arKey, uint nKeyLength); + +/* Data retreival */ +ZEND_API int zend_ts_hash_find(TsHashTable *ht, char *arKey, uint nKeyLength, void **pData); +ZEND_API int zend_ts_hash_quick_find(TsHashTable *ht, char *arKey, uint nKeyLength, ulong h, void **pData); +ZEND_API int zend_ts_hash_index_find(TsHashTable *ht, ulong h, void **pData); + +/* Misc */ +ZEND_API int zend_ts_hash_exists(TsHashTable *ht, char *arKey, uint nKeyLength); +ZEND_API int zend_ts_hash_index_exists(TsHashTable *ht, ulong h); + +/* Copying, merging and sorting */ +ZEND_API void zend_ts_hash_copy(TsHashTable *target, TsHashTable *source, copy_ctor_func_t pCopyConstructor, void *tmp, uint size); +ZEND_API void zend_ts_hash_merge(TsHashTable *target, TsHashTable *source, copy_ctor_func_t pCopyConstructor, void *tmp, uint size, int overwrite); +ZEND_API void zend_ts_hash_merge_ex(TsHashTable *target, TsHashTable *source, copy_ctor_func_t pCopyConstructor, uint size, zend_bool (*pReplaceOrig)(void *orig, void *p_new)); +ZEND_API int zend_ts_hash_sort(TsHashTable *ht, sort_func_t sort_func, compare_func_t compare_func, int renumber TSRMLS_DC); +ZEND_API int zend_ts_hash_compare(TsHashTable *ht1, TsHashTable *ht2, compare_func_t compar, zend_bool ordered TSRMLS_DC); +ZEND_API int zend_ts_hash_minmax(TsHashTable *ht, compare_func_t compar, int flag, void **pData TSRMLS_DC); + +ZEND_API int zend_ts_hash_num_elements(TsHashTable *ht); + +ZEND_API int zend_ts_hash_rehash(TsHashTable *ht); + +ZEND_API ulong zend_ts_hash_func(char *arKey, uint nKeyLength); + +#if ZEND_DEBUG +/* debug */ +void zend_ts_hash_display_pListTail(TsHashTable *ht); +void zend_ts_hash_display(TsHashTable *ht); +#endif + +END_EXTERN_C() + +#define ZEND_TS_INIT_SYMTABLE(ht) \ + ZEND_TS_INIT_SYMTABLE_EX(ht, 2, 0) + +#define ZEND_TS_INIT_SYMTABLE_EX(ht, n, persistent) \ + zend_ts_hash_init(ht, n, NULL, ZVAL_PTR_DTOR, persistent) + + +#endif /* ZEND_HASH_H */ |