1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
/**
* \file lib/rpmhash.h
* Hash table implemenation.
*/
#include <string.h>
// Hackery to make sure that macros get expanded
#define __JOIN(a,b) a##b
#define JOIN(a,b) __JOIN(a,b)
#define HASHPREFIX(name) JOIN(HASHTYPE,name)
#define HASHSTRUCT JOIN(HASHTYPE,_s)
typedef struct HASHSTRUCT * HASHTYPE;
/* function pointer types to deal with the datatypes the hash works with */
#define hashFunctionType JOIN(HASHTYPE,HashFunctionType)
#define hashEqualityType JOIN(HASHTYPE,HashEqualityType)
#define hashFreeKey JOIN(HASHTYPE,FreeKey)
typedef unsigned int (*hashFunctionType) (HTKEYTYPE string);
typedef int (*hashEqualityType) (HTKEYTYPE key1, HTKEYTYPE key2);
typedef HTKEYTYPE (*hashFreeKey) (HTKEYTYPE);
#ifdef HTDATATYPE
#define hashFreeData JOIN(HASHTYPE,FreeData)
typedef HTDATATYPE (*hashFreeData) (HTDATATYPE);
#endif
/**
* Create hash table.
* If keySize > 0, the key is duplicated within the table (which costs
* memory, but may be useful anyway.
* @param numBuckets number of hash buckets
* @param fn function to generate hash value for key
* @param eq function to compare hash keys for equality
* @param freeKey function to free the keys or NULL
* @param freeData function to free the data or NULL
* @return pointer to initialized hash table
*/
RPM_GNUC_INTERNAL
HASHTYPE HASHPREFIX(Create)(int numBuckets,
hashFunctionType fn, hashEqualityType eq,
hashFreeKey freeKey
#ifdef HTDATATYPE
, hashFreeData freeData
#endif
);
/**
* Destroy hash table.
* @param ht pointer to hash table
* @return NULL always
*/
RPM_GNUC_INTERNAL
HASHTYPE HASHPREFIX(Free)( HASHTYPE ht);
/**
* Remove all entries from the hash table.
* @param ht pointer to hash table
*/
RPM_GNUC_INTERNAL
void HASHPREFIX(Empty)(HASHTYPE ht);
/**
* Add item to hash table.
* @param ht pointer to hash table
* @param key key
* @param data data value
*/
RPM_GNUC_INTERNAL
void HASHPREFIX(AddEntry)(HASHTYPE ht, HTKEYTYPE key
#ifdef HTDATATYPE
, HTDATATYPE data
#endif
);
/**
* Retrieve item from hash table.
* @param ht pointer to hash table
* @param key key value
* @retval data address to store data value from bucket
* @retval dataCount address to store data value size from bucket
* @retval tableKey address to store key value from bucket (may be NULL)
* @return 1 on success, 0 if the item is not found.
*/
RPM_GNUC_INTERNAL
int HASHPREFIX(GetEntry)(HASHTYPE ht, HTKEYTYPE key,
#ifdef HTDATATYPE
HTDATATYPE** data,
int * dataCount,
#endif
HTKEYTYPE* tableKey);
/**
* Check for key in hash table.
* @param ht pointer to hash table
* @param key key value
* @return 1 if the key is present, 0 otherwise
*/
RPM_GNUC_INTERNAL
int HASHPREFIX(HasEntry)(HASHTYPE ht, HTKEYTYPE key);
/**
* How many buckets are currently allocated (result is implementation
* dependent)
* @param ht pointer to hash table
* @result number of buckets allocated
*/
RPM_GNUC_INTERNAL
unsigned int HASHPREFIX(NumBuckets)(HASHTYPE ht);
/**
* How many buckets are used (result is implementation dependent)
* @param ht pointer to hash table
* @result number of buckets used
*/
RPM_GNUC_INTERNAL
unsigned int HASHPREFIX(UsedBuckets)(HASHTYPE ht);
/**
* How many (unique) keys have been added to the hash table
* @param ht pointer to hash table
* @result number of unique keys
*/
RPM_GNUC_INTERNAL
unsigned int HASHPREFIX(NumKeys)(HASHTYPE ht);
#ifdef HTDATATYPE
/**
* How many data entries have been added to the hash table
* @param ht pointer to hash table
* @result number of data entries
*/
RPM_GNUC_INTERNAL
unsigned int HASHPREFIX(NumData)(HASHTYPE ht);
#endif
/**
* Print statistics about the hash to stderr
* This is for debugging only
* @param ht pointer to hash table
*/
RPM_GNUC_INTERNAL
void HASHPREFIX(PrintStats)(HASHTYPE ht);
|
