/usr/include/libAfterBase/ashash.h is in libafterimage-dev 2.2.12-11.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 | #ifndef ASHASH_HEADER_FILE_INCLUDED
#define ASHASH_HEADER_FILE_INCLUDED
/* REALY USEFULL and UNIVERSAL hash table implementation */
#include "astypes.h"
#ifdef __cplusplus
extern "C" {
#endif
struct wild_reg_exp;
#if 0
typedef union ASHashableValue
{
unsigned long long_val;
char *string_val;
struct wild_reg_exp *wrexp_val; /* regular expression */
void *ptr ;
}ASHashableValue;
#else
typedef unsigned long ASHashableValueBase;
typedef const ASHashableValueBase ASHashableValue;
#endif
typedef union ASHashData
{
void *vptr ;
int *iptr ;
unsigned int *uiptr ;
long *lptr ;
unsigned long *ulptr ;
char *cptr ;
int i ;
unsigned int ui ;
long l ;
unsigned long ul ;
CARD32 c32 ;
CARD16 c16 ;
CARD8 c8 ;
}ASHashData;
#define AS_HASHABLE(v) ((ASHashableValue)((const unsigned long)(v)))
typedef struct ASHashItem
{
struct ASHashItem *next;
ASHashableValueBase value;
void *data; /* optional data structure related to this
hashable value */
}
ASHashItem;
typedef unsigned short ASHashKey;
typedef ASHashItem *ASHashBucket;
typedef struct ASHashTable
{
ASHashKey size;
ASHashBucket *buckets;
ASHashKey buckets_used;
unsigned long items_num;
ASHashItem *most_recent ;
ASHashKey (*hash_func) (ASHashableValue value, ASHashKey hash_size);
long (*compare_func) (ASHashableValue value1, ASHashableValue value2);
void (*item_destroy_func) (ASHashableValue value, void *data);
}
ASHashTable;
typedef struct ASHashIterator
{
ASHashKey curr_bucket;
ASHashItem **curr_item;
ASHashTable *hash;
}
ASHashIterator;
void init_ashash (ASHashTable * hash, Bool freeresources);
/* Note that all parameters are optional here.
If it is set to NULL - defaults will be used */
#define DEFAULT_HASH_SIZE 0x03F /* random value - not too big - not too small - but mast be a mask to avoid % */
/* default hash_func is long_val%hash_size */
/* default compare_func is long_val1-long_val2 */
ASHashTable *create_ashash (ASHashKey size,
ASHashKey (*hash_func) (ASHashableValue,ASHashKey),
long (*compare_func) (ASHashableValue, ASHashableValue),
void (*item_destroy_func) (ASHashableValue,void *));
void print_ashash (ASHashTable * hash,
void (*item_print_func) (ASHashableValue value));
void print_ashash2 (ASHashTable * hash,
void (*item_print_func) (ASHashableValue value, void *data));
void destroy_ashash (ASHashTable ** hash);
typedef enum
{
ASH_BadParameter = -3,
ASH_ItemNotExists = -2,
ASH_ItemExistsDiffer = -1,
ASH_ItemExistsSame = 0,
ASH_Success = 1
}
ASHashResult;
ASHashResult add_hash_item (ASHashTable * hash, ASHashableValue value,
void *data);
/* Note that trg parameter is optional here */
ASHashResult get_hash_item (const ASHashTable * hash, ASHashableValue value,
void **trg);
/* here if trg is NULL then both data and value will be destroyed;
otherwise only value will be destroyed.
Note: if you never specifyed destroy_func - nothing will be destroyed,
except for HashItem itself.
*/
ASHashResult remove_hash_item (ASHashTable * hash, ASHashableValue value,
void **trg, Bool destroy);
/* removes all the items from hash table */
void flush_ashash (ASHashTable * hash);
/* need to run this in order to free up cached memory */
void flush_ashash_memory_pool();
/* if max_items == 0 then all hash items will be returned */
unsigned long sort_hash_items (ASHashTable * hash, ASHashableValueBase * values,
void **data, unsigned long max_items);
unsigned long list_hash_items (ASHashTable * hash, ASHashableValueBase * values,
void **data, unsigned long max_items);
Bool start_hash_iteration (ASHashTable * hash, ASHashIterator * iterator);
Bool next_hash_item (ASHashIterator * iterator);
ASHashableValue curr_hash_value (ASHashIterator * iterator);
void *curr_hash_data (ASHashIterator * iterator);
void remove_curr_hash_item (ASHashIterator * iterator, Bool destroy);
/**************************************************************************/
/**************************************************************************/
/* here is the set of implemented hash functions : */
/**************************************************************************/
ASHashKey pointer_hash_value (ASHashableValue value, ASHashKey hash_size);
long
desc_long_compare_func (ASHashableValue value1, ASHashableValue value2);
/* configuration options - case unsensitive and spaces are not alowed */
ASHashKey option_hash_value (ASHashableValue value, ASHashKey hash_size);
long option_compare (ASHashableValue value1, ASHashableValue value2);
/* case unsensitive strings - spaces and control chars are alowed */
ASHashKey casestring_hash_value (ASHashableValue value, ASHashKey hash_size);
long casestring_compare (ASHashableValue value1, ASHashableValue value2);
/* case sensitive strings - spaces and control chars are alowed */
ASHashKey string_hash_value (ASHashableValue value, ASHashKey hash_size);
long string_compare (ASHashableValue value1, ASHashableValue value2);
void string_destroy (ASHashableValue value, void *data);
void string_destroy_without_data (ASHashableValue value, void *data);
void string_print (ASHashableValue value);
/* basically any long value, but was written originally for colors hash */
ASHashKey color_hash_value (ASHashableValue value, ASHashKey hash_size);
#ifdef __cplusplus
}
#endif
#endif
|