mirror of
https://github.com/krahets/hello-algo.git
synced 2026-11-02 03:05:24 +08:00
* feat(ko): add the complete Korean online edition * Use UTF-8 for Python CI output on Windows * Remove print-book promotion from the Korean site * fix(ko): preserve emphasis before Korean particles
1141 lines
74 KiB
C
1141 lines
74 KiB
C
/*
|
|
Copyright (c) 2003-2022, Troy D. Hanson https://troydhanson.github.io/uthash/
|
|
All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions are met:
|
|
|
|
* Redistributions of source code must retain the above copyright
|
|
notice, this list of conditions and the following disclaimer.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
|
|
IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
|
TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
|
|
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
|
|
OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
|
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
|
|
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
|
|
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
|
|
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
#ifndef UTHASH_H
|
|
#define UTHASH_H
|
|
|
|
#define UTHASH_VERSION 2.3.0
|
|
|
|
#include <string.h> /* memcmp, memset, strlen */
|
|
#include <stddef.h> /* ptrdiff_t */
|
|
#include <stdlib.h> /* exit */
|
|
|
|
#if defined(HASH_DEFINE_OWN_STDINT) && HASH_DEFINE_OWN_STDINT
|
|
/* 이 코드 경로는 하위 호환성을 위해 제공하지만, 향후 제거할 예정이다. */
|
|
#warning "HASH_DEFINE_OWN_STDINT는 더 이상 권장되지 않는다. 대신 HASH_NO_STDINT를 사용한다"
|
|
typedef unsigned int uint32_t;
|
|
typedef unsigned char uint8_t;
|
|
#elif defined(HASH_NO_STDINT) && HASH_NO_STDINT
|
|
#else
|
|
#include <stdint.h> /* uint8_t, uint32_t */
|
|
#endif
|
|
|
|
/* 이 매크로들은 decltype 또는 이전 GNU 확장인 __typeof를 사용한다.
|
|
decltype은 최신 컴파일러(C++ 소스를 컴파일할 때 VS2010 또는 gcc 4.3 이상)에서만
|
|
사용할 수 있으므로, 이 코드는 상황에 맞는 방법을 사용한다.
|
|
둘 다 사용할 수 없는 VS2008에서는 형 변환으로 우회한다. */
|
|
#if !defined(DECLTYPE) && !defined(NO_DECLTYPE)
|
|
#if defined(_MSC_VER) /* MS 컴파일러 */
|
|
#if _MSC_VER >= 1600 && defined(__cplusplus) /* C++ 모드의 VS2010 이상 */
|
|
#define DECLTYPE(x) (decltype(x))
|
|
#else /* VS2008 이하(또는 C 모드의 VS2010) */
|
|
#define NO_DECLTYPE
|
|
#endif
|
|
#elif defined(__MCST__) /* Elbrus C 컴파일러 */
|
|
#define DECLTYPE(x) (__typeof(x))
|
|
#elif defined(__BORLANDC__) || defined(__ICCARM__) || defined(__LCC__) || defined(__WATCOMC__)
|
|
#define NO_DECLTYPE
|
|
#else /* GNU, Sun 및 기타 컴파일러 */
|
|
#define DECLTYPE(x) (__typeof(x))
|
|
#endif
|
|
#endif
|
|
|
|
#ifdef NO_DECLTYPE
|
|
#define DECLTYPE(x)
|
|
#define DECLTYPE_ASSIGN(dst,src) \
|
|
do { \
|
|
char **_da_dst = (char**)(&(dst)); \
|
|
*_da_dst = (char*)(src); \
|
|
} while (0)
|
|
#else
|
|
#define DECLTYPE_ASSIGN(dst,src) \
|
|
do { \
|
|
(dst) = DECLTYPE(dst)(src); \
|
|
} while (0)
|
|
#endif
|
|
|
|
#ifndef uthash_malloc
|
|
#define uthash_malloc(sz) malloc(sz) /* malloc 함수 */
|
|
#endif
|
|
#ifndef uthash_free
|
|
#define uthash_free(ptr,sz) free(ptr) /* free 함수 */
|
|
#endif
|
|
#ifndef uthash_bzero
|
|
#define uthash_bzero(a,n) memset(a,'\0',n)
|
|
#endif
|
|
#ifndef uthash_strlen
|
|
#define uthash_strlen(s) strlen(s)
|
|
#endif
|
|
|
|
#ifndef HASH_FUNCTION
|
|
#define HASH_FUNCTION(keyptr,keylen,hashv) HASH_JEN(keyptr, keylen, hashv)
|
|
#endif
|
|
|
|
#ifndef HASH_KEYCMP
|
|
#define HASH_KEYCMP(a,b,n) memcmp(a,b,n)
|
|
#endif
|
|
|
|
#ifndef uthash_noexpand_fyi
|
|
#define uthash_noexpand_fyi(tbl) /* 확장 중지 내역을 기록하도록 정의할 수 있다 */
|
|
#endif
|
|
#ifndef uthash_expand_fyi
|
|
#define uthash_expand_fyi(tbl) /* 확장 내역을 기록하도록 정의할 수 있다 */
|
|
#endif
|
|
|
|
#ifndef HASH_NONFATAL_OOM
|
|
#define HASH_NONFATAL_OOM 0
|
|
#endif
|
|
|
|
#if HASH_NONFATAL_OOM
|
|
/* malloc 실패에서 복구할 수 있다 */
|
|
|
|
#ifndef uthash_nonfatal_oom
|
|
#define uthash_nonfatal_oom(obj) do {} while (0) /* 치명적이지 않은 메모리 부족 오류 */
|
|
#endif
|
|
|
|
#define HASH_RECORD_OOM(oomed) do { (oomed) = 1; } while (0)
|
|
#define IF_HASH_NONFATAL_OOM(x) x
|
|
|
|
#else
|
|
/* malloc 실패 시 메모리가 유실되고 해시 테이블을 사용할 수 없게 된다 */
|
|
|
|
#ifndef uthash_fatal
|
|
#define uthash_fatal(msg) exit(-1) /* 치명적인 메모리 부족 오류 */
|
|
#endif
|
|
|
|
#define HASH_RECORD_OOM(oomed) uthash_fatal("메모리 부족")
|
|
#define IF_HASH_NONFATAL_OOM(x)
|
|
|
|
#endif
|
|
|
|
/* 초기 버킷 수 */
|
|
#define HASH_INITIAL_NUM_BUCKETS 32U /* 초기 버킷 수 */
|
|
#define HASH_INITIAL_NUM_BUCKETS_LOG2 5U /* 초기 버킷 수의 밑이 2인 로그 */
|
|
#define HASH_BKT_CAPACITY_THRESH 10U /* 버킷의 원소 수가 이 값에 도달하면 확장한다 */
|
|
|
|
/* 해시 핸들 주소가 hhp인 원소를 계산한다 */
|
|
#define ELMT_FROM_HH(tbl,hhp) ((void*)(((char*)(hhp)) - ((tbl)->hho)))
|
|
/* 원소 주소 elp에서 해시 핸들을 계산한다 */
|
|
#define HH_FROM_ELMT(tbl,elp) ((UT_hash_handle*)(void*)(((char*)(elp)) + ((tbl)->hho)))
|
|
|
|
#define HASH_ROLLBACK_BKT(hh, head, itemptrhh) \
|
|
do { \
|
|
struct UT_hash_handle *_hd_hh_item = (itemptrhh); \
|
|
unsigned _hd_bkt; \
|
|
HASH_TO_BKT(_hd_hh_item->hashv, (head)->hh.tbl->num_buckets, _hd_bkt); \
|
|
(head)->hh.tbl->buckets[_hd_bkt].count++; \
|
|
_hd_hh_item->hh_next = NULL; \
|
|
_hd_hh_item->hh_prev = NULL; \
|
|
} while (0)
|
|
|
|
#define HASH_VALUE(keyptr,keylen,hashv) \
|
|
do { \
|
|
HASH_FUNCTION(keyptr, keylen, hashv); \
|
|
} while (0)
|
|
|
|
#define HASH_FIND_BYHASHVALUE(hh,head,keyptr,keylen,hashval,out) \
|
|
do { \
|
|
(out) = NULL; \
|
|
if (head) { \
|
|
unsigned _hf_bkt; \
|
|
HASH_TO_BKT(hashval, (head)->hh.tbl->num_buckets, _hf_bkt); \
|
|
if (HASH_BLOOM_TEST((head)->hh.tbl, hashval) != 0) { \
|
|
HASH_FIND_IN_BKT((head)->hh.tbl, hh, (head)->hh.tbl->buckets[ _hf_bkt ], keyptr, keylen, hashval, out); \
|
|
} \
|
|
} \
|
|
} while (0)
|
|
|
|
#define HASH_FIND(hh,head,keyptr,keylen,out) \
|
|
do { \
|
|
(out) = NULL; \
|
|
if (head) { \
|
|
unsigned _hf_hashv; \
|
|
HASH_VALUE(keyptr, keylen, _hf_hashv); \
|
|
HASH_FIND_BYHASHVALUE(hh, head, keyptr, keylen, _hf_hashv, out); \
|
|
} \
|
|
} while (0)
|
|
|
|
#ifdef HASH_BLOOM
|
|
#define HASH_BLOOM_BITLEN (1UL << HASH_BLOOM)
|
|
#define HASH_BLOOM_BYTELEN (HASH_BLOOM_BITLEN/8UL) + (((HASH_BLOOM_BITLEN%8UL)!=0UL) ? 1UL : 0UL)
|
|
#define HASH_BLOOM_MAKE(tbl,oomed) \
|
|
do { \
|
|
(tbl)->bloom_nbits = HASH_BLOOM; \
|
|
(tbl)->bloom_bv = (uint8_t*)uthash_malloc(HASH_BLOOM_BYTELEN); \
|
|
if (!(tbl)->bloom_bv) { \
|
|
HASH_RECORD_OOM(oomed); \
|
|
} else { \
|
|
uthash_bzero((tbl)->bloom_bv, HASH_BLOOM_BYTELEN); \
|
|
(tbl)->bloom_sig = HASH_BLOOM_SIGNATURE; \
|
|
} \
|
|
} while (0)
|
|
|
|
#define HASH_BLOOM_FREE(tbl) \
|
|
do { \
|
|
uthash_free((tbl)->bloom_bv, HASH_BLOOM_BYTELEN); \
|
|
} while (0)
|
|
|
|
#define HASH_BLOOM_BITSET(bv,idx) (bv[(idx)/8U] |= (1U << ((idx)%8U)))
|
|
#define HASH_BLOOM_BITTEST(bv,idx) (bv[(idx)/8U] & (1U << ((idx)%8U)))
|
|
|
|
#define HASH_BLOOM_ADD(tbl,hashv) \
|
|
HASH_BLOOM_BITSET((tbl)->bloom_bv, ((hashv) & (uint32_t)((1UL << (tbl)->bloom_nbits) - 1U)))
|
|
|
|
#define HASH_BLOOM_TEST(tbl,hashv) \
|
|
HASH_BLOOM_BITTEST((tbl)->bloom_bv, ((hashv) & (uint32_t)((1UL << (tbl)->bloom_nbits) - 1U)))
|
|
|
|
#else
|
|
#define HASH_BLOOM_MAKE(tbl,oomed)
|
|
#define HASH_BLOOM_FREE(tbl)
|
|
#define HASH_BLOOM_ADD(tbl,hashv)
|
|
#define HASH_BLOOM_TEST(tbl,hashv) (1)
|
|
#define HASH_BLOOM_BYTELEN 0U
|
|
#endif
|
|
|
|
#define HASH_MAKE_TABLE(hh,head,oomed) \
|
|
do { \
|
|
(head)->hh.tbl = (UT_hash_table*)uthash_malloc(sizeof(UT_hash_table)); \
|
|
if (!(head)->hh.tbl) { \
|
|
HASH_RECORD_OOM(oomed); \
|
|
} else { \
|
|
uthash_bzero((head)->hh.tbl, sizeof(UT_hash_table)); \
|
|
(head)->hh.tbl->tail = &((head)->hh); \
|
|
(head)->hh.tbl->num_buckets = HASH_INITIAL_NUM_BUCKETS; \
|
|
(head)->hh.tbl->log2_num_buckets = HASH_INITIAL_NUM_BUCKETS_LOG2; \
|
|
(head)->hh.tbl->hho = (char*)(&(head)->hh) - (char*)(head); \
|
|
(head)->hh.tbl->buckets = (UT_hash_bucket*)uthash_malloc( \
|
|
HASH_INITIAL_NUM_BUCKETS * sizeof(struct UT_hash_bucket)); \
|
|
(head)->hh.tbl->signature = HASH_SIGNATURE; \
|
|
if (!(head)->hh.tbl->buckets) { \
|
|
HASH_RECORD_OOM(oomed); \
|
|
uthash_free((head)->hh.tbl, sizeof(UT_hash_table)); \
|
|
} else { \
|
|
uthash_bzero((head)->hh.tbl->buckets, \
|
|
HASH_INITIAL_NUM_BUCKETS * sizeof(struct UT_hash_bucket)); \
|
|
HASH_BLOOM_MAKE((head)->hh.tbl, oomed); \
|
|
IF_HASH_NONFATAL_OOM( \
|
|
if (oomed) { \
|
|
uthash_free((head)->hh.tbl->buckets, \
|
|
HASH_INITIAL_NUM_BUCKETS*sizeof(struct UT_hash_bucket)); \
|
|
uthash_free((head)->hh.tbl, sizeof(UT_hash_table)); \
|
|
} \
|
|
) \
|
|
} \
|
|
} \
|
|
} while (0)
|
|
|
|
#define HASH_REPLACE_BYHASHVALUE_INORDER(hh,head,fieldname,keylen_in,hashval,add,replaced,cmpfcn) \
|
|
do { \
|
|
(replaced) = NULL; \
|
|
HASH_FIND_BYHASHVALUE(hh, head, &((add)->fieldname), keylen_in, hashval, replaced); \
|
|
if (replaced) { \
|
|
HASH_DELETE(hh, head, replaced); \
|
|
} \
|
|
HASH_ADD_KEYPTR_BYHASHVALUE_INORDER(hh, head, &((add)->fieldname), keylen_in, hashval, add, cmpfcn); \
|
|
} while (0)
|
|
|
|
#define HASH_REPLACE_BYHASHVALUE(hh,head,fieldname,keylen_in,hashval,add,replaced) \
|
|
do { \
|
|
(replaced) = NULL; \
|
|
HASH_FIND_BYHASHVALUE(hh, head, &((add)->fieldname), keylen_in, hashval, replaced); \
|
|
if (replaced) { \
|
|
HASH_DELETE(hh, head, replaced); \
|
|
} \
|
|
HASH_ADD_KEYPTR_BYHASHVALUE(hh, head, &((add)->fieldname), keylen_in, hashval, add); \
|
|
} while (0)
|
|
|
|
#define HASH_REPLACE(hh,head,fieldname,keylen_in,add,replaced) \
|
|
do { \
|
|
unsigned _hr_hashv; \
|
|
HASH_VALUE(&((add)->fieldname), keylen_in, _hr_hashv); \
|
|
HASH_REPLACE_BYHASHVALUE(hh, head, fieldname, keylen_in, _hr_hashv, add, replaced); \
|
|
} while (0)
|
|
|
|
#define HASH_REPLACE_INORDER(hh,head,fieldname,keylen_in,add,replaced,cmpfcn) \
|
|
do { \
|
|
unsigned _hr_hashv; \
|
|
HASH_VALUE(&((add)->fieldname), keylen_in, _hr_hashv); \
|
|
HASH_REPLACE_BYHASHVALUE_INORDER(hh, head, fieldname, keylen_in, _hr_hashv, add, replaced, cmpfcn); \
|
|
} while (0)
|
|
|
|
#define HASH_APPEND_LIST(hh, head, add) \
|
|
do { \
|
|
(add)->hh.next = NULL; \
|
|
(add)->hh.prev = ELMT_FROM_HH((head)->hh.tbl, (head)->hh.tbl->tail); \
|
|
(head)->hh.tbl->tail->next = (add); \
|
|
(head)->hh.tbl->tail = &((add)->hh); \
|
|
} while (0)
|
|
|
|
#define HASH_AKBI_INNER_LOOP(hh,head,add,cmpfcn) \
|
|
do { \
|
|
do { \
|
|
if (cmpfcn(DECLTYPE(head)(_hs_iter), add) > 0) { \
|
|
break; \
|
|
} \
|
|
} while ((_hs_iter = HH_FROM_ELMT((head)->hh.tbl, _hs_iter)->next)); \
|
|
} while (0)
|
|
|
|
#ifdef NO_DECLTYPE
|
|
#undef HASH_AKBI_INNER_LOOP
|
|
#define HASH_AKBI_INNER_LOOP(hh,head,add,cmpfcn) \
|
|
do { \
|
|
char *_hs_saved_head = (char*)(head); \
|
|
do { \
|
|
DECLTYPE_ASSIGN(head, _hs_iter); \
|
|
if (cmpfcn(head, add) > 0) { \
|
|
DECLTYPE_ASSIGN(head, _hs_saved_head); \
|
|
break; \
|
|
} \
|
|
DECLTYPE_ASSIGN(head, _hs_saved_head); \
|
|
} while ((_hs_iter = HH_FROM_ELMT((head)->hh.tbl, _hs_iter)->next)); \
|
|
} while (0)
|
|
#endif
|
|
|
|
#if HASH_NONFATAL_OOM
|
|
|
|
#define HASH_ADD_TO_TABLE(hh,head,keyptr,keylen_in,hashval,add,oomed) \
|
|
do { \
|
|
if (!(oomed)) { \
|
|
unsigned _ha_bkt; \
|
|
(head)->hh.tbl->num_items++; \
|
|
HASH_TO_BKT(hashval, (head)->hh.tbl->num_buckets, _ha_bkt); \
|
|
HASH_ADD_TO_BKT((head)->hh.tbl->buckets[_ha_bkt], hh, &(add)->hh, oomed); \
|
|
if (oomed) { \
|
|
HASH_ROLLBACK_BKT(hh, head, &(add)->hh); \
|
|
HASH_DELETE_HH(hh, head, &(add)->hh); \
|
|
(add)->hh.tbl = NULL; \
|
|
uthash_nonfatal_oom(add); \
|
|
} else { \
|
|
HASH_BLOOM_ADD((head)->hh.tbl, hashval); \
|
|
HASH_EMIT_KEY(hh, head, keyptr, keylen_in); \
|
|
} \
|
|
} else { \
|
|
(add)->hh.tbl = NULL; \
|
|
uthash_nonfatal_oom(add); \
|
|
} \
|
|
} while (0)
|
|
|
|
#else
|
|
|
|
#define HASH_ADD_TO_TABLE(hh,head,keyptr,keylen_in,hashval,add,oomed) \
|
|
do { \
|
|
unsigned _ha_bkt; \
|
|
(head)->hh.tbl->num_items++; \
|
|
HASH_TO_BKT(hashval, (head)->hh.tbl->num_buckets, _ha_bkt); \
|
|
HASH_ADD_TO_BKT((head)->hh.tbl->buckets[_ha_bkt], hh, &(add)->hh, oomed); \
|
|
HASH_BLOOM_ADD((head)->hh.tbl, hashval); \
|
|
HASH_EMIT_KEY(hh, head, keyptr, keylen_in); \
|
|
} while (0)
|
|
|
|
#endif
|
|
|
|
|
|
#define HASH_ADD_KEYPTR_BYHASHVALUE_INORDER(hh,head,keyptr,keylen_in,hashval,add,cmpfcn) \
|
|
do { \
|
|
IF_HASH_NONFATAL_OOM( int _ha_oomed = 0; ) \
|
|
(add)->hh.hashv = (hashval); \
|
|
(add)->hh.key = (char*) (keyptr); \
|
|
(add)->hh.keylen = (unsigned) (keylen_in); \
|
|
if (!(head)) { \
|
|
(add)->hh.next = NULL; \
|
|
(add)->hh.prev = NULL; \
|
|
HASH_MAKE_TABLE(hh, add, _ha_oomed); \
|
|
IF_HASH_NONFATAL_OOM( if (!_ha_oomed) { ) \
|
|
(head) = (add); \
|
|
IF_HASH_NONFATAL_OOM( } ) \
|
|
} else { \
|
|
void *_hs_iter = (head); \
|
|
(add)->hh.tbl = (head)->hh.tbl; \
|
|
HASH_AKBI_INNER_LOOP(hh, head, add, cmpfcn); \
|
|
if (_hs_iter) { \
|
|
(add)->hh.next = _hs_iter; \
|
|
if (((add)->hh.prev = HH_FROM_ELMT((head)->hh.tbl, _hs_iter)->prev)) { \
|
|
HH_FROM_ELMT((head)->hh.tbl, (add)->hh.prev)->next = (add); \
|
|
} else { \
|
|
(head) = (add); \
|
|
} \
|
|
HH_FROM_ELMT((head)->hh.tbl, _hs_iter)->prev = (add); \
|
|
} else { \
|
|
HASH_APPEND_LIST(hh, head, add); \
|
|
} \
|
|
} \
|
|
HASH_ADD_TO_TABLE(hh, head, keyptr, keylen_in, hashval, add, _ha_oomed); \
|
|
HASH_FSCK(hh, head, "HASH_ADD_KEYPTR_BYHASHVALUE_INORDER"); \
|
|
} while (0)
|
|
|
|
#define HASH_ADD_KEYPTR_INORDER(hh,head,keyptr,keylen_in,add,cmpfcn) \
|
|
do { \
|
|
unsigned _hs_hashv; \
|
|
HASH_VALUE(keyptr, keylen_in, _hs_hashv); \
|
|
HASH_ADD_KEYPTR_BYHASHVALUE_INORDER(hh, head, keyptr, keylen_in, _hs_hashv, add, cmpfcn); \
|
|
} while (0)
|
|
|
|
#define HASH_ADD_BYHASHVALUE_INORDER(hh,head,fieldname,keylen_in,hashval,add,cmpfcn) \
|
|
HASH_ADD_KEYPTR_BYHASHVALUE_INORDER(hh, head, &((add)->fieldname), keylen_in, hashval, add, cmpfcn)
|
|
|
|
#define HASH_ADD_INORDER(hh,head,fieldname,keylen_in,add,cmpfcn) \
|
|
HASH_ADD_KEYPTR_INORDER(hh, head, &((add)->fieldname), keylen_in, add, cmpfcn)
|
|
|
|
#define HASH_ADD_KEYPTR_BYHASHVALUE(hh,head,keyptr,keylen_in,hashval,add) \
|
|
do { \
|
|
IF_HASH_NONFATAL_OOM( int _ha_oomed = 0; ) \
|
|
(add)->hh.hashv = (hashval); \
|
|
(add)->hh.key = (const void*) (keyptr); \
|
|
(add)->hh.keylen = (unsigned) (keylen_in); \
|
|
if (!(head)) { \
|
|
(add)->hh.next = NULL; \
|
|
(add)->hh.prev = NULL; \
|
|
HASH_MAKE_TABLE(hh, add, _ha_oomed); \
|
|
IF_HASH_NONFATAL_OOM( if (!_ha_oomed) { ) \
|
|
(head) = (add); \
|
|
IF_HASH_NONFATAL_OOM( } ) \
|
|
} else { \
|
|
(add)->hh.tbl = (head)->hh.tbl; \
|
|
HASH_APPEND_LIST(hh, head, add); \
|
|
} \
|
|
HASH_ADD_TO_TABLE(hh, head, keyptr, keylen_in, hashval, add, _ha_oomed); \
|
|
HASH_FSCK(hh, head, "HASH_ADD_KEYPTR_BYHASHVALUE"); \
|
|
} while (0)
|
|
|
|
#define HASH_ADD_KEYPTR(hh,head,keyptr,keylen_in,add) \
|
|
do { \
|
|
unsigned _ha_hashv; \
|
|
HASH_VALUE(keyptr, keylen_in, _ha_hashv); \
|
|
HASH_ADD_KEYPTR_BYHASHVALUE(hh, head, keyptr, keylen_in, _ha_hashv, add); \
|
|
} while (0)
|
|
|
|
#define HASH_ADD_BYHASHVALUE(hh,head,fieldname,keylen_in,hashval,add) \
|
|
HASH_ADD_KEYPTR_BYHASHVALUE(hh, head, &((add)->fieldname), keylen_in, hashval, add)
|
|
|
|
#define HASH_ADD(hh,head,fieldname,keylen_in,add) \
|
|
HASH_ADD_KEYPTR(hh, head, &((add)->fieldname), keylen_in, add)
|
|
|
|
#define HASH_TO_BKT(hashv,num_bkts,bkt) \
|
|
do { \
|
|
bkt = ((hashv) & ((num_bkts) - 1U)); \
|
|
} while (0)
|
|
|
|
/* 해시 테이블에서 "delptr"를 삭제한다.
|
|
* 애플리케이션 순서의 이중 연결 리스트에서 수행하는 "일반적인" 연결 복구 과정이다.
|
|
* 아래에서 _hd_hh_del을 사용하는 이유는 별도의 설명이 필요하다.
|
|
* 이전에는 (delptr)를 사용했지만, 다음과 같이
|
|
* 머리와 삭제 대상에 같은 이름을 사용하면 버그가 발생했다.
|
|
* HASH_DELETE(hh,users,users);
|
|
* 이 경우에도 동작해야 하지만, 아래에서 머리(users)를 변경하면
|
|
* 연결을 복구하는 과정에서 삭제 대상(users)을
|
|
* 더 이상 참조할 수 없게 된다. 해결 방법은 임시 공간에
|
|
* 삭제 대상의 포인터를 복사하고, 이후에는 가리키는 대상이 바뀐 (users) 대신
|
|
* 그 임시 포인터를 통해 참조하는 것이다.
|
|
*/
|
|
#define HASH_DELETE(hh,head,delptr) \
|
|
HASH_DELETE_HH(hh, head, &(delptr)->hh)
|
|
|
|
#define HASH_DELETE_HH(hh,head,delptrhh) \
|
|
do { \
|
|
const struct UT_hash_handle *_hd_hh_del = (delptrhh); \
|
|
if ((_hd_hh_del->prev == NULL) && (_hd_hh_del->next == NULL)) { \
|
|
HASH_BLOOM_FREE((head)->hh.tbl); \
|
|
uthash_free((head)->hh.tbl->buckets, \
|
|
(head)->hh.tbl->num_buckets * sizeof(struct UT_hash_bucket)); \
|
|
uthash_free((head)->hh.tbl, sizeof(UT_hash_table)); \
|
|
(head) = NULL; \
|
|
} else { \
|
|
unsigned _hd_bkt; \
|
|
if (_hd_hh_del == (head)->hh.tbl->tail) { \
|
|
(head)->hh.tbl->tail = HH_FROM_ELMT((head)->hh.tbl, _hd_hh_del->prev); \
|
|
} \
|
|
if (_hd_hh_del->prev != NULL) { \
|
|
HH_FROM_ELMT((head)->hh.tbl, _hd_hh_del->prev)->next = _hd_hh_del->next; \
|
|
} else { \
|
|
DECLTYPE_ASSIGN(head, _hd_hh_del->next); \
|
|
} \
|
|
if (_hd_hh_del->next != NULL) { \
|
|
HH_FROM_ELMT((head)->hh.tbl, _hd_hh_del->next)->prev = _hd_hh_del->prev; \
|
|
} \
|
|
HASH_TO_BKT(_hd_hh_del->hashv, (head)->hh.tbl->num_buckets, _hd_bkt); \
|
|
HASH_DEL_IN_BKT((head)->hh.tbl->buckets[_hd_bkt], _hd_hh_del); \
|
|
(head)->hh.tbl->num_items--; \
|
|
} \
|
|
HASH_FSCK(hh, head, "HASH_DELETE_HH"); \
|
|
} while (0)
|
|
|
|
/* HASH_FIND/HASH_ADD/HASH_DEL의 편의 형식 */
|
|
#define HASH_FIND_STR(head,findstr,out) \
|
|
do { \
|
|
unsigned _uthash_hfstr_keylen = (unsigned)uthash_strlen(findstr); \
|
|
HASH_FIND(hh, head, findstr, _uthash_hfstr_keylen, out); \
|
|
} while (0)
|
|
#define HASH_ADD_STR(head,strfield,add) \
|
|
do { \
|
|
unsigned _uthash_hastr_keylen = (unsigned)uthash_strlen((add)->strfield); \
|
|
HASH_ADD(hh, head, strfield[0], _uthash_hastr_keylen, add); \
|
|
} while (0)
|
|
#define HASH_REPLACE_STR(head,strfield,add,replaced) \
|
|
do { \
|
|
unsigned _uthash_hrstr_keylen = (unsigned)uthash_strlen((add)->strfield); \
|
|
HASH_REPLACE(hh, head, strfield[0], _uthash_hrstr_keylen, add, replaced); \
|
|
} while (0)
|
|
#define HASH_FIND_INT(head,findint,out) \
|
|
HASH_FIND(hh,head,findint,sizeof(int),out)
|
|
#define HASH_ADD_INT(head,intfield,add) \
|
|
HASH_ADD(hh,head,intfield,sizeof(int),add)
|
|
#define HASH_REPLACE_INT(head,intfield,add,replaced) \
|
|
HASH_REPLACE(hh,head,intfield,sizeof(int),add,replaced)
|
|
#define HASH_FIND_PTR(head,findptr,out) \
|
|
HASH_FIND(hh,head,findptr,sizeof(void *),out)
|
|
#define HASH_ADD_PTR(head,ptrfield,add) \
|
|
HASH_ADD(hh,head,ptrfield,sizeof(void *),add)
|
|
#define HASH_REPLACE_PTR(head,ptrfield,add,replaced) \
|
|
HASH_REPLACE(hh,head,ptrfield,sizeof(void *),add,replaced)
|
|
#define HASH_DEL(head,delptr) \
|
|
HASH_DELETE(hh,head,delptr)
|
|
|
|
/* HASH_DEBUG가 정의되어 있으면 HASH_FSCK는 추가/삭제할 때마다 해시 무결성을 검사한다.
|
|
* uthash 개발자 전용이며, HASH_DEBUG가 정의되지 않으면 컴파일 시 제거된다.
|
|
*/
|
|
#ifdef HASH_DEBUG
|
|
#include <stdio.h> /* fprintf, stderr */
|
|
#define HASH_OOPS(...) do { fprintf(stderr, __VA_ARGS__); exit(-1); } while (0)
|
|
#define HASH_FSCK(hh,head,where) \
|
|
do { \
|
|
struct UT_hash_handle *_thh; \
|
|
if (head) { \
|
|
unsigned _bkt_i; \
|
|
unsigned _count = 0; \
|
|
char *_prev; \
|
|
for (_bkt_i = 0; _bkt_i < (head)->hh.tbl->num_buckets; ++_bkt_i) { \
|
|
unsigned _bkt_count = 0; \
|
|
_thh = (head)->hh.tbl->buckets[_bkt_i].hh_head; \
|
|
_prev = NULL; \
|
|
while (_thh) { \
|
|
if (_prev != (char*)(_thh->hh_prev)) { \
|
|
HASH_OOPS("%s: 잘못된 hh_prev %p, 실제 값 %p\n", \
|
|
(where), (void*)_thh->hh_prev, (void*)_prev); \
|
|
} \
|
|
_bkt_count++; \
|
|
_prev = (char*)(_thh); \
|
|
_thh = _thh->hh_next; \
|
|
} \
|
|
_count += _bkt_count; \
|
|
if ((head)->hh.tbl->buckets[_bkt_i].count != _bkt_count) { \
|
|
HASH_OOPS("%s: 잘못된 버킷 원소 수 %u, 실제 값 %u\n", \
|
|
(where), (head)->hh.tbl->buckets[_bkt_i].count, _bkt_count); \
|
|
} \
|
|
} \
|
|
if (_count != (head)->hh.tbl->num_items) { \
|
|
HASH_OOPS("%s: 잘못된 hh 원소 수 %u, 실제 값 %u\n", \
|
|
(where), (head)->hh.tbl->num_items, _count); \
|
|
} \
|
|
_count = 0; \
|
|
_prev = NULL; \
|
|
_thh = &(head)->hh; \
|
|
while (_thh) { \
|
|
_count++; \
|
|
if (_prev != (char*)_thh->prev) { \
|
|
HASH_OOPS("%s: 잘못된 prev %p, 실제 값 %p\n", \
|
|
(where), (void*)_thh->prev, (void*)_prev); \
|
|
} \
|
|
_prev = (char*)ELMT_FROM_HH((head)->hh.tbl, _thh); \
|
|
_thh = (_thh->next ? HH_FROM_ELMT((head)->hh.tbl, _thh->next) : NULL); \
|
|
} \
|
|
if (_count != (head)->hh.tbl->num_items) { \
|
|
HASH_OOPS("%s: 잘못된 애플리케이션 원소 수 %u, 실제 값 %u\n", \
|
|
(where), (head)->hh.tbl->num_items, _count); \
|
|
} \
|
|
} \
|
|
} while (0)
|
|
#else
|
|
#define HASH_FSCK(hh,head,where)
|
|
#endif
|
|
|
|
/* -DHASH_EMIT_KEYS로 컴파일하면 길이가 앞에 붙은 키를
|
|
* 이 매크로의 값으로 지정한 디스크립터에 출력하여 해시 함수를 조정할 수 있다.
|
|
* 애플리케이션은 #include <unistd.h>로 write(2)의 함수 원형을 가져올 수 있다. */
|
|
#ifdef HASH_EMIT_KEYS
|
|
#define HASH_EMIT_KEY(hh,head,keyptr,fieldlen) \
|
|
do { \
|
|
unsigned _klen = fieldlen; \
|
|
write(HASH_EMIT_KEYS, &_klen, sizeof(_klen)); \
|
|
write(HASH_EMIT_KEYS, keyptr, (unsigned long)fieldlen); \
|
|
} while (0)
|
|
#else
|
|
#define HASH_EMIT_KEY(hh,head,keyptr,fieldlen)
|
|
#endif
|
|
|
|
/* Perl v5.6 이전에 사용된 Bernstein 해시 함수이다. (x<<5+x)=x*33임에 유의한다. */
|
|
#define HASH_BER(key,keylen,hashv) \
|
|
do { \
|
|
unsigned _hb_keylen = (unsigned)keylen; \
|
|
const unsigned char *_hb_key = (const unsigned char*)(key); \
|
|
(hashv) = 0; \
|
|
while (_hb_keylen-- != 0U) { \
|
|
(hashv) = (((hashv) << 5) + (hashv)) + *_hb_key++; \
|
|
} \
|
|
} while (0)
|
|
|
|
|
|
/* SAX/FNV/OAT/JEN 해시 함수는 다음 주소에 나열된 함수들의 매크로 변형이다
|
|
* http://eternallyconfuzzled.com/tuts/algorithms/jsw_tut_hashing.aspx
|
|
* (보관된 링크: https://archive.is/Ivcan )
|
|
*/
|
|
#define HASH_SAX(key,keylen,hashv) \
|
|
do { \
|
|
unsigned _sx_i; \
|
|
const unsigned char *_hs_key = (const unsigned char*)(key); \
|
|
hashv = 0; \
|
|
for (_sx_i=0; _sx_i < keylen; _sx_i++) { \
|
|
hashv ^= (hashv << 5) + (hashv >> 2) + _hs_key[_sx_i]; \
|
|
} \
|
|
} while (0)
|
|
/* FNV-1a 변형 */
|
|
#define HASH_FNV(key,keylen,hashv) \
|
|
do { \
|
|
unsigned _fn_i; \
|
|
const unsigned char *_hf_key = (const unsigned char*)(key); \
|
|
(hashv) = 2166136261U; \
|
|
for (_fn_i=0; _fn_i < keylen; _fn_i++) { \
|
|
hashv = hashv ^ _hf_key[_fn_i]; \
|
|
hashv = hashv * 16777619U; \
|
|
} \
|
|
} while (0)
|
|
|
|
#define HASH_OAT(key,keylen,hashv) \
|
|
do { \
|
|
unsigned _ho_i; \
|
|
const unsigned char *_ho_key=(const unsigned char*)(key); \
|
|
hashv = 0; \
|
|
for(_ho_i=0; _ho_i < keylen; _ho_i++) { \
|
|
hashv += _ho_key[_ho_i]; \
|
|
hashv += (hashv << 10); \
|
|
hashv ^= (hashv >> 6); \
|
|
} \
|
|
hashv += (hashv << 3); \
|
|
hashv ^= (hashv >> 11); \
|
|
hashv += (hashv << 15); \
|
|
} while (0)
|
|
|
|
#define HASH_JEN_MIX(a,b,c) \
|
|
do { \
|
|
a -= b; a -= c; a ^= ( c >> 13 ); \
|
|
b -= c; b -= a; b ^= ( a << 8 ); \
|
|
c -= a; c -= b; c ^= ( b >> 13 ); \
|
|
a -= b; a -= c; a ^= ( c >> 12 ); \
|
|
b -= c; b -= a; b ^= ( a << 16 ); \
|
|
c -= a; c -= b; c ^= ( b >> 5 ); \
|
|
a -= b; a -= c; a ^= ( c >> 3 ); \
|
|
b -= c; b -= a; b ^= ( a << 10 ); \
|
|
c -= a; c -= b; c ^= ( b >> 15 ); \
|
|
} while (0)
|
|
|
|
#define HASH_JEN(key,keylen,hashv) \
|
|
do { \
|
|
unsigned _hj_i,_hj_j,_hj_k; \
|
|
unsigned const char *_hj_key=(unsigned const char*)(key); \
|
|
hashv = 0xfeedbeefu; \
|
|
_hj_i = _hj_j = 0x9e3779b9u; \
|
|
_hj_k = (unsigned)(keylen); \
|
|
while (_hj_k >= 12U) { \
|
|
_hj_i += (_hj_key[0] + ( (unsigned)_hj_key[1] << 8 ) \
|
|
+ ( (unsigned)_hj_key[2] << 16 ) \
|
|
+ ( (unsigned)_hj_key[3] << 24 ) ); \
|
|
_hj_j += (_hj_key[4] + ( (unsigned)_hj_key[5] << 8 ) \
|
|
+ ( (unsigned)_hj_key[6] << 16 ) \
|
|
+ ( (unsigned)_hj_key[7] << 24 ) ); \
|
|
hashv += (_hj_key[8] + ( (unsigned)_hj_key[9] << 8 ) \
|
|
+ ( (unsigned)_hj_key[10] << 16 ) \
|
|
+ ( (unsigned)_hj_key[11] << 24 ) ); \
|
|
\
|
|
HASH_JEN_MIX(_hj_i, _hj_j, hashv); \
|
|
\
|
|
_hj_key += 12; \
|
|
_hj_k -= 12U; \
|
|
} \
|
|
hashv += (unsigned)(keylen); \
|
|
switch ( _hj_k ) { \
|
|
case 11: hashv += ( (unsigned)_hj_key[10] << 24 ); /* FALLTHROUGH */ \
|
|
case 10: hashv += ( (unsigned)_hj_key[9] << 16 ); /* FALLTHROUGH */ \
|
|
case 9: hashv += ( (unsigned)_hj_key[8] << 8 ); /* FALLTHROUGH */ \
|
|
case 8: _hj_j += ( (unsigned)_hj_key[7] << 24 ); /* FALLTHROUGH */ \
|
|
case 7: _hj_j += ( (unsigned)_hj_key[6] << 16 ); /* FALLTHROUGH */ \
|
|
case 6: _hj_j += ( (unsigned)_hj_key[5] << 8 ); /* FALLTHROUGH */ \
|
|
case 5: _hj_j += _hj_key[4]; /* FALLTHROUGH */ \
|
|
case 4: _hj_i += ( (unsigned)_hj_key[3] << 24 ); /* FALLTHROUGH */ \
|
|
case 3: _hj_i += ( (unsigned)_hj_key[2] << 16 ); /* FALLTHROUGH */ \
|
|
case 2: _hj_i += ( (unsigned)_hj_key[1] << 8 ); /* FALLTHROUGH */ \
|
|
case 1: _hj_i += _hj_key[0]; /* FALLTHROUGH */ \
|
|
default: ; \
|
|
} \
|
|
HASH_JEN_MIX(_hj_i, _hj_j, hashv); \
|
|
} while (0)
|
|
|
|
/* Paul Hsieh 해시 함수 */
|
|
#undef get16bits
|
|
#if (defined(__GNUC__) && defined(__i386__)) || defined(__WATCOMC__) \
|
|
|| defined(_MSC_VER) || defined (__BORLANDC__) || defined (__TURBOC__)
|
|
#define get16bits(d) (*((const uint16_t *) (d)))
|
|
#endif
|
|
|
|
#if !defined (get16bits)
|
|
#define get16bits(d) ((((uint32_t)(((const uint8_t *)(d))[1])) << 8) \
|
|
+(uint32_t)(((const uint8_t *)(d))[0]) )
|
|
#endif
|
|
#define HASH_SFH(key,keylen,hashv) \
|
|
do { \
|
|
unsigned const char *_sfh_key=(unsigned const char*)(key); \
|
|
uint32_t _sfh_tmp, _sfh_len = (uint32_t)keylen; \
|
|
\
|
|
unsigned _sfh_rem = _sfh_len & 3U; \
|
|
_sfh_len >>= 2; \
|
|
hashv = 0xcafebabeu; \
|
|
\
|
|
/* 주 반복문 */ \
|
|
for (;_sfh_len > 0U; _sfh_len--) { \
|
|
hashv += get16bits (_sfh_key); \
|
|
_sfh_tmp = ((uint32_t)(get16bits (_sfh_key+2)) << 11) ^ hashv; \
|
|
hashv = (hashv << 16) ^ _sfh_tmp; \
|
|
_sfh_key += 2U*sizeof (uint16_t); \
|
|
hashv += hashv >> 11; \
|
|
} \
|
|
\
|
|
/* 남은 부분을 처리한다 */ \
|
|
switch (_sfh_rem) { \
|
|
case 3: hashv += get16bits (_sfh_key); \
|
|
hashv ^= hashv << 16; \
|
|
hashv ^= (uint32_t)(_sfh_key[sizeof (uint16_t)]) << 18; \
|
|
hashv += hashv >> 11; \
|
|
break; \
|
|
case 2: hashv += get16bits (_sfh_key); \
|
|
hashv ^= hashv << 11; \
|
|
hashv += hashv >> 17; \
|
|
break; \
|
|
case 1: hashv += *_sfh_key; \
|
|
hashv ^= hashv << 10; \
|
|
hashv += hashv >> 1; \
|
|
break; \
|
|
default: ; \
|
|
} \
|
|
\
|
|
/* 마지막 127비트에 "눈사태 효과"를 강제로 일으킨다 */ \
|
|
hashv ^= hashv << 3; \
|
|
hashv += hashv >> 5; \
|
|
hashv ^= hashv << 4; \
|
|
hashv += hashv >> 17; \
|
|
hashv ^= hashv << 25; \
|
|
hashv += hashv >> 6; \
|
|
} while (0)
|
|
|
|
/* 지정된 버킷의 원소들을 순회하여 원하는 원소를 찾는다 */
|
|
#define HASH_FIND_IN_BKT(tbl,hh,head,keyptr,keylen_in,hashval,out) \
|
|
do { \
|
|
if ((head).hh_head != NULL) { \
|
|
DECLTYPE_ASSIGN(out, ELMT_FROM_HH(tbl, (head).hh_head)); \
|
|
} else { \
|
|
(out) = NULL; \
|
|
} \
|
|
while ((out) != NULL) { \
|
|
if ((out)->hh.hashv == (hashval) && (out)->hh.keylen == (keylen_in)) { \
|
|
if (HASH_KEYCMP((out)->hh.key, keyptr, keylen_in) == 0) { \
|
|
break; \
|
|
} \
|
|
} \
|
|
if ((out)->hh.hh_next != NULL) { \
|
|
DECLTYPE_ASSIGN(out, ELMT_FROM_HH(tbl, (out)->hh.hh_next)); \
|
|
} else { \
|
|
(out) = NULL; \
|
|
} \
|
|
} \
|
|
} while (0)
|
|
|
|
/* 버킷에 원소를 추가한다 */
|
|
#define HASH_ADD_TO_BKT(head,hh,addhh,oomed) \
|
|
do { \
|
|
UT_hash_bucket *_ha_head = &(head); \
|
|
_ha_head->count++; \
|
|
(addhh)->hh_next = _ha_head->hh_head; \
|
|
(addhh)->hh_prev = NULL; \
|
|
if (_ha_head->hh_head != NULL) { \
|
|
_ha_head->hh_head->hh_prev = (addhh); \
|
|
} \
|
|
_ha_head->hh_head = (addhh); \
|
|
if ((_ha_head->count >= ((_ha_head->expand_mult + 1U) * HASH_BKT_CAPACITY_THRESH)) \
|
|
&& !(addhh)->tbl->noexpand) { \
|
|
HASH_EXPAND_BUCKETS(addhh,(addhh)->tbl, oomed); \
|
|
IF_HASH_NONFATAL_OOM( \
|
|
if (oomed) { \
|
|
HASH_DEL_IN_BKT(head,addhh); \
|
|
} \
|
|
) \
|
|
} \
|
|
} while (0)
|
|
|
|
/* 지정된 버킷에서 원소를 삭제한다 */
|
|
#define HASH_DEL_IN_BKT(head,delhh) \
|
|
do { \
|
|
UT_hash_bucket *_hd_head = &(head); \
|
|
_hd_head->count--; \
|
|
if (_hd_head->hh_head == (delhh)) { \
|
|
_hd_head->hh_head = (delhh)->hh_next; \
|
|
} \
|
|
if ((delhh)->hh_prev) { \
|
|
(delhh)->hh_prev->hh_next = (delhh)->hh_next; \
|
|
} \
|
|
if ((delhh)->hh_next) { \
|
|
(delhh)->hh_next->hh_prev = (delhh)->hh_prev; \
|
|
} \
|
|
} while (0)
|
|
|
|
/* 버킷을 확장하면 버킷 수가 두 배가 되고
|
|
* 원소들이 새 버킷들로 재분배된다. 이상적으로는
|
|
* 원소들이 새 버킷에 대체로 균등하게 분배된다
|
|
* (이것이 성립하는 정도는 해당 키 영역에서
|
|
* 해시 함수의 품질을 평가하는 척도이다).
|
|
*
|
|
* 원소들이 더 많은 버킷에 분배되면 각 버킷의 체인 길이
|
|
* (원소 수)가 줄어든다. 따라서 버킷 확장을 통해
|
|
* 해시는 체인 길이에 상한을 유지한다. 이렇게 체인 길이에
|
|
* 상한이 있다는 것이 해시가 상수 시간 탐색을 제공하는 핵심이다.
|
|
*
|
|
* 아래에서 tbl->ideal_chain_maxlen을 계산하는 방법에는
|
|
* 설명이 필요하다. 먼저 이상적인 최대 체인 길이를
|
|
* *새로운*(두 배로 늘어난) 버킷 수를 기준으로 계산한다는 점에 유의한다.
|
|
* 분수로 나타내면 n/b이다(n=원소 수, b=새 버킷 수).
|
|
* 이상적인 체인 길이는 정수이므로 계산하려는 값은
|
|
* ceil(n/b)이다. 이 해시에서는 부동 소수점 연산에 의존하지 않으므로
|
|
* 정수로 ceil(n/b)를 계산하려면 다음과 같이 쓸 수 있다
|
|
*
|
|
* ceil(n/b) = (n/b) + ((n%b)?1:0)
|
|
*
|
|
* 실제로 이 해시의 이전 버전은 바로 이 방법을 사용했다.
|
|
* 하지만 b가 항상 2의 거듭제곱이라는 점을 이용하여
|
|
* 조금 개선했다. 밑이 2인 로그를 보관해 두고 이를 lb라고 하면,
|
|
* 비트 시프트와 논리 AND를 사용하여 다음과 같이 쓸 수 있다:
|
|
*
|
|
* ceil(n/b) = (n>>lb) + ( (n & (b-1)) ? 1:0)
|
|
*
|
|
*/
|
|
#define HASH_EXPAND_BUCKETS(hh,tbl,oomed) \
|
|
do { \
|
|
unsigned _he_bkt; \
|
|
unsigned _he_bkt_i; \
|
|
struct UT_hash_handle *_he_thh, *_he_hh_nxt; \
|
|
UT_hash_bucket *_he_new_buckets, *_he_newbkt; \
|
|
_he_new_buckets = (UT_hash_bucket*)uthash_malloc( \
|
|
sizeof(struct UT_hash_bucket) * (tbl)->num_buckets * 2U); \
|
|
if (!_he_new_buckets) { \
|
|
HASH_RECORD_OOM(oomed); \
|
|
} else { \
|
|
uthash_bzero(_he_new_buckets, \
|
|
sizeof(struct UT_hash_bucket) * (tbl)->num_buckets * 2U); \
|
|
(tbl)->ideal_chain_maxlen = \
|
|
((tbl)->num_items >> ((tbl)->log2_num_buckets+1U)) + \
|
|
((((tbl)->num_items & (((tbl)->num_buckets*2U)-1U)) != 0U) ? 1U : 0U); \
|
|
(tbl)->nonideal_items = 0; \
|
|
for (_he_bkt_i = 0; _he_bkt_i < (tbl)->num_buckets; _he_bkt_i++) { \
|
|
_he_thh = (tbl)->buckets[ _he_bkt_i ].hh_head; \
|
|
while (_he_thh != NULL) { \
|
|
_he_hh_nxt = _he_thh->hh_next; \
|
|
HASH_TO_BKT(_he_thh->hashv, (tbl)->num_buckets * 2U, _he_bkt); \
|
|
_he_newbkt = &(_he_new_buckets[_he_bkt]); \
|
|
if (++(_he_newbkt->count) > (tbl)->ideal_chain_maxlen) { \
|
|
(tbl)->nonideal_items++; \
|
|
if (_he_newbkt->count > _he_newbkt->expand_mult * (tbl)->ideal_chain_maxlen) { \
|
|
_he_newbkt->expand_mult++; \
|
|
} \
|
|
} \
|
|
_he_thh->hh_prev = NULL; \
|
|
_he_thh->hh_next = _he_newbkt->hh_head; \
|
|
if (_he_newbkt->hh_head != NULL) { \
|
|
_he_newbkt->hh_head->hh_prev = _he_thh; \
|
|
} \
|
|
_he_newbkt->hh_head = _he_thh; \
|
|
_he_thh = _he_hh_nxt; \
|
|
} \
|
|
} \
|
|
uthash_free((tbl)->buckets, (tbl)->num_buckets * sizeof(struct UT_hash_bucket)); \
|
|
(tbl)->num_buckets *= 2U; \
|
|
(tbl)->log2_num_buckets++; \
|
|
(tbl)->buckets = _he_new_buckets; \
|
|
(tbl)->ineff_expands = ((tbl)->nonideal_items > ((tbl)->num_items >> 1)) ? \
|
|
((tbl)->ineff_expands+1U) : 0U; \
|
|
if ((tbl)->ineff_expands > 1U) { \
|
|
(tbl)->noexpand = 1; \
|
|
uthash_noexpand_fyi(tbl); \
|
|
} \
|
|
uthash_expand_fyi(tbl); \
|
|
} \
|
|
} while (0)
|
|
|
|
|
|
/* Simon Tatham의 O(n log(n)) 병합 정렬을 변형한 것이다 */
|
|
/* HASH_SORT는 해시 핸들 이름이 hh라고 가정한다는 점에 유의한다.
|
|
* HASH_SRT는 해시 핸들 이름을 전달할 수 있도록 추가되었다. */
|
|
#define HASH_SORT(head,cmpfcn) HASH_SRT(hh,head,cmpfcn)
|
|
#define HASH_SRT(hh,head,cmpfcn) \
|
|
do { \
|
|
unsigned _hs_i; \
|
|
unsigned _hs_looping,_hs_nmerges,_hs_insize,_hs_psize,_hs_qsize; \
|
|
struct UT_hash_handle *_hs_p, *_hs_q, *_hs_e, *_hs_list, *_hs_tail; \
|
|
if (head != NULL) { \
|
|
_hs_insize = 1; \
|
|
_hs_looping = 1; \
|
|
_hs_list = &((head)->hh); \
|
|
while (_hs_looping != 0U) { \
|
|
_hs_p = _hs_list; \
|
|
_hs_list = NULL; \
|
|
_hs_tail = NULL; \
|
|
_hs_nmerges = 0; \
|
|
while (_hs_p != NULL) { \
|
|
_hs_nmerges++; \
|
|
_hs_q = _hs_p; \
|
|
_hs_psize = 0; \
|
|
for (_hs_i = 0; _hs_i < _hs_insize; ++_hs_i) { \
|
|
_hs_psize++; \
|
|
_hs_q = ((_hs_q->next != NULL) ? \
|
|
HH_FROM_ELMT((head)->hh.tbl, _hs_q->next) : NULL); \
|
|
if (_hs_q == NULL) { \
|
|
break; \
|
|
} \
|
|
} \
|
|
_hs_qsize = _hs_insize; \
|
|
while ((_hs_psize != 0U) || ((_hs_qsize != 0U) && (_hs_q != NULL))) { \
|
|
if (_hs_psize == 0U) { \
|
|
_hs_e = _hs_q; \
|
|
_hs_q = ((_hs_q->next != NULL) ? \
|
|
HH_FROM_ELMT((head)->hh.tbl, _hs_q->next) : NULL); \
|
|
_hs_qsize--; \
|
|
} else if ((_hs_qsize == 0U) || (_hs_q == NULL)) { \
|
|
_hs_e = _hs_p; \
|
|
if (_hs_p != NULL) { \
|
|
_hs_p = ((_hs_p->next != NULL) ? \
|
|
HH_FROM_ELMT((head)->hh.tbl, _hs_p->next) : NULL); \
|
|
} \
|
|
_hs_psize--; \
|
|
} else if ((cmpfcn( \
|
|
DECLTYPE(head)(ELMT_FROM_HH((head)->hh.tbl, _hs_p)), \
|
|
DECLTYPE(head)(ELMT_FROM_HH((head)->hh.tbl, _hs_q)) \
|
|
)) <= 0) { \
|
|
_hs_e = _hs_p; \
|
|
if (_hs_p != NULL) { \
|
|
_hs_p = ((_hs_p->next != NULL) ? \
|
|
HH_FROM_ELMT((head)->hh.tbl, _hs_p->next) : NULL); \
|
|
} \
|
|
_hs_psize--; \
|
|
} else { \
|
|
_hs_e = _hs_q; \
|
|
_hs_q = ((_hs_q->next != NULL) ? \
|
|
HH_FROM_ELMT((head)->hh.tbl, _hs_q->next) : NULL); \
|
|
_hs_qsize--; \
|
|
} \
|
|
if ( _hs_tail != NULL ) { \
|
|
_hs_tail->next = ((_hs_e != NULL) ? \
|
|
ELMT_FROM_HH((head)->hh.tbl, _hs_e) : NULL); \
|
|
} else { \
|
|
_hs_list = _hs_e; \
|
|
} \
|
|
if (_hs_e != NULL) { \
|
|
_hs_e->prev = ((_hs_tail != NULL) ? \
|
|
ELMT_FROM_HH((head)->hh.tbl, _hs_tail) : NULL); \
|
|
} \
|
|
_hs_tail = _hs_e; \
|
|
} \
|
|
_hs_p = _hs_q; \
|
|
} \
|
|
if (_hs_tail != NULL) { \
|
|
_hs_tail->next = NULL; \
|
|
} \
|
|
if (_hs_nmerges <= 1U) { \
|
|
_hs_looping = 0; \
|
|
(head)->hh.tbl->tail = _hs_tail; \
|
|
DECLTYPE_ASSIGN(head, ELMT_FROM_HH((head)->hh.tbl, _hs_list)); \
|
|
} \
|
|
_hs_insize *= 2U; \
|
|
} \
|
|
HASH_FSCK(hh, head, "HASH_SRT"); \
|
|
} \
|
|
} while (0)
|
|
|
|
/* 이 함수는 한 해시에서 원소를 골라 다른 해시에 넣는다.
|
|
* 결과적으로 선택된 원소들은
|
|
* 두 해시에 동시에 존재한다. 원소를 복사하는 것은 아니며,
|
|
* 구조체에 반드시 존재해야 하는 보조 해시
|
|
* 핸들을 통해 새 해시에 추가한다. */
|
|
#define HASH_SELECT(hh_dst, dst, hh_src, src, cond) \
|
|
do { \
|
|
unsigned _src_bkt, _dst_bkt; \
|
|
void *_last_elt = NULL, *_elt; \
|
|
UT_hash_handle *_src_hh, *_dst_hh, *_last_elt_hh=NULL; \
|
|
ptrdiff_t _dst_hho = ((char*)(&(dst)->hh_dst) - (char*)(dst)); \
|
|
if ((src) != NULL) { \
|
|
for (_src_bkt=0; _src_bkt < (src)->hh_src.tbl->num_buckets; _src_bkt++) { \
|
|
for (_src_hh = (src)->hh_src.tbl->buckets[_src_bkt].hh_head; \
|
|
_src_hh != NULL; \
|
|
_src_hh = _src_hh->hh_next) { \
|
|
_elt = ELMT_FROM_HH((src)->hh_src.tbl, _src_hh); \
|
|
if (cond(_elt)) { \
|
|
IF_HASH_NONFATAL_OOM( int _hs_oomed = 0; ) \
|
|
_dst_hh = (UT_hash_handle*)(void*)(((char*)_elt) + _dst_hho); \
|
|
_dst_hh->key = _src_hh->key; \
|
|
_dst_hh->keylen = _src_hh->keylen; \
|
|
_dst_hh->hashv = _src_hh->hashv; \
|
|
_dst_hh->prev = _last_elt; \
|
|
_dst_hh->next = NULL; \
|
|
if (_last_elt_hh != NULL) { \
|
|
_last_elt_hh->next = _elt; \
|
|
} \
|
|
if ((dst) == NULL) { \
|
|
DECLTYPE_ASSIGN(dst, _elt); \
|
|
HASH_MAKE_TABLE(hh_dst, dst, _hs_oomed); \
|
|
IF_HASH_NONFATAL_OOM( \
|
|
if (_hs_oomed) { \
|
|
uthash_nonfatal_oom(_elt); \
|
|
(dst) = NULL; \
|
|
continue; \
|
|
} \
|
|
) \
|
|
} else { \
|
|
_dst_hh->tbl = (dst)->hh_dst.tbl; \
|
|
} \
|
|
HASH_TO_BKT(_dst_hh->hashv, _dst_hh->tbl->num_buckets, _dst_bkt); \
|
|
HASH_ADD_TO_BKT(_dst_hh->tbl->buckets[_dst_bkt], hh_dst, _dst_hh, _hs_oomed); \
|
|
(dst)->hh_dst.tbl->num_items++; \
|
|
IF_HASH_NONFATAL_OOM( \
|
|
if (_hs_oomed) { \
|
|
HASH_ROLLBACK_BKT(hh_dst, dst, _dst_hh); \
|
|
HASH_DELETE_HH(hh_dst, dst, _dst_hh); \
|
|
_dst_hh->tbl = NULL; \
|
|
uthash_nonfatal_oom(_elt); \
|
|
continue; \
|
|
} \
|
|
) \
|
|
HASH_BLOOM_ADD(_dst_hh->tbl, _dst_hh->hashv); \
|
|
_last_elt = _elt; \
|
|
_last_elt_hh = _dst_hh; \
|
|
} \
|
|
} \
|
|
} \
|
|
} \
|
|
HASH_FSCK(hh_dst, dst, "HASH_SELECT"); \
|
|
} while (0)
|
|
|
|
#define HASH_CLEAR(hh,head) \
|
|
do { \
|
|
if ((head) != NULL) { \
|
|
HASH_BLOOM_FREE((head)->hh.tbl); \
|
|
uthash_free((head)->hh.tbl->buckets, \
|
|
(head)->hh.tbl->num_buckets*sizeof(struct UT_hash_bucket)); \
|
|
uthash_free((head)->hh.tbl, sizeof(UT_hash_table)); \
|
|
(head) = NULL; \
|
|
} \
|
|
} while (0)
|
|
|
|
#define HASH_OVERHEAD(hh,head) \
|
|
(((head) != NULL) ? ( \
|
|
(size_t)(((head)->hh.tbl->num_items * sizeof(UT_hash_handle)) + \
|
|
((head)->hh.tbl->num_buckets * sizeof(UT_hash_bucket)) + \
|
|
sizeof(UT_hash_table) + \
|
|
(HASH_BLOOM_BYTELEN))) : 0U)
|
|
|
|
#ifdef NO_DECLTYPE
|
|
#define HASH_ITER(hh,head,el,tmp) \
|
|
for(((el)=(head)), ((*(char**)(&(tmp)))=(char*)((head!=NULL)?(head)->hh.next:NULL)); \
|
|
(el) != NULL; ((el)=(tmp)), ((*(char**)(&(tmp)))=(char*)((tmp!=NULL)?(tmp)->hh.next:NULL)))
|
|
#else
|
|
#define HASH_ITER(hh,head,el,tmp) \
|
|
for(((el)=(head)), ((tmp)=DECLTYPE(el)((head!=NULL)?(head)->hh.next:NULL)); \
|
|
(el) != NULL; ((el)=(tmp)), ((tmp)=DECLTYPE(el)((tmp!=NULL)?(tmp)->hh.next:NULL)))
|
|
#endif
|
|
|
|
/* 해시에 있는 원소 수를 구한다 */
|
|
#define HASH_COUNT(head) HASH_CNT(hh,head)
|
|
#define HASH_CNT(hh,head) ((head != NULL)?((head)->hh.tbl->num_items):0U)
|
|
|
|
typedef struct UT_hash_bucket {
|
|
struct UT_hash_handle *hh_head;
|
|
unsigned count;
|
|
|
|
/* expand_mult는 보통 0으로 설정한다. 이 경우 최대 체인 길이의
|
|
* 임곗값은 기본값인 HASH_BKT_CAPACITY_THRESH로 적용된다.
|
|
* (버킷의 체인이 이 길이를 초과하면 버킷 확장이 발생한다.)
|
|
* 그러나 expand_mult를 0이 아닌 값으로 설정하면 버킷 확장이 지연된다.
|
|
* 즉, 이 특정 버킷에 원소를 추가하여 발생할 확장을
|
|
* 체인 길이가 HASH_BKT_CAPACITY_THRESH의 *배수*에 도달할 때까지 미룬다.
|
|
* (배수는 단순히 expand_mult+1이다.) 이 배수를 사용하는
|
|
* 목적은 비용이 큰 버킷 확장을 줄이는 것이다.
|
|
* 특정 버킷이 과도하게 사용되는 경향이 있음을 알 때 유용하다.
|
|
* O(n)의 버킷 확장을 지나치게 자주 수행하는 것보다
|
|
* 체인 길이가 더 길어지더라도 상한 안에서 증가하도록 두는 편이 낫다.
|
|
*/
|
|
unsigned expand_mult;
|
|
|
|
} UT_hash_bucket;
|
|
|
|
/* 외부 분석에서 해시 테이블을 찾는 데만 사용하는 임의의 시그니처 */
|
|
#define HASH_SIGNATURE 0xa0111fe1u
|
|
#define HASH_BLOOM_SIGNATURE 0xb12220f2u
|
|
|
|
typedef struct UT_hash_table {
|
|
UT_hash_bucket *buckets;
|
|
unsigned num_buckets, log2_num_buckets;
|
|
unsigned num_items;
|
|
struct UT_hash_handle *tail; /* 빠른 끝 추가를 위한 애플리케이션 순서의 마지막 hh */
|
|
ptrdiff_t hho; /* 해시 핸들의 오프셋(원소 내 해시 핸들의 바이트 위치 */
|
|
|
|
/* 이상적인 상황(모든 버킷이 균등하게 사용됨)에서는 어느 버킷도
|
|
* ceil(#items/#buckets)보다 많은 원소를 갖지 않는다. 이것이 이상적인 체인 길이이다. */
|
|
unsigned ideal_chain_maxlen;
|
|
|
|
/* nonideal_items는 해시에서 체인 내 위치가
|
|
* 이상적인 최대 체인 길이를 초과하는 원소의 수이다. 이 원소들은 불균등한
|
|
* 해시 분포의 영향을 받아, 체인을 순회하여 도달하는 데 이상적인 횟수보다 많은 단계가 필요하다 */
|
|
unsigned nonideal_items;
|
|
|
|
/* 비효율적인 확장이란 버킷 수를 두 배로 늘린 뒤에도
|
|
* 해시 원소의 과반수가 이상적인 범위를 벗어난
|
|
* 체인 위치에 있는 경우이다. 연속 두 번의 확장에서 이런 일이 발생하면
|
|
* 추가 확장은 도움이 되지 않으므로 더 이상 확장하지 않는다. 이는 해시
|
|
* 함수가 키 영역에 잘 맞지 않을 때 발생한다. 확장을 중지해도
|
|
* 해시는 계속 동작하지만 더 이상 상수 시간을 보장하지 않는다. */
|
|
unsigned ineff_expands, noexpand;
|
|
|
|
uint32_t signature; /* 외부 분석에서 해시 테이블을 찾는 데만 사용한다 */
|
|
#ifdef HASH_BLOOM
|
|
uint32_t bloom_sig; /* 외부 분석에서 블룸 필터가 있는지 확인하는 데만 사용한다 */
|
|
uint8_t *bloom_bv;
|
|
uint8_t bloom_nbits;
|
|
#endif
|
|
|
|
} UT_hash_table;
|
|
|
|
typedef struct UT_hash_handle {
|
|
struct UT_hash_table *tbl;
|
|
void *prev; /* 애플리케이션 순서의 이전 원소 */
|
|
void *next; /* 애플리케이션 순서의 다음 원소 */
|
|
struct UT_hash_handle *hh_prev; /* 버킷 순서의 이전 hh */
|
|
struct UT_hash_handle *hh_next; /* 버킷 순서의 다음 hh */
|
|
const void *key; /* 이를 포함하는 구조체의 키를 가리키는 포인터 */
|
|
unsigned keylen; /* 이를 포함하는 구조체의 키 길이 */
|
|
unsigned hashv; /* hash-fcn(key)의 결과 */
|
|
} UT_hash_handle;
|
|
|
|
#endif /* UTHASH_H */
|