/usr/include/sdrhash.h is in libion-dev 3.2.1+dfsg-1.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 | /*
sdrhash.h: definitions supporting use of SDR hash tables.
Hash tables associate values with keys. A
value is always in the form of an SDR Address,
nominally the address of some stored object
identified by the associated key, but the
actual significance of a value may be
anything that fits into an unsigned long.
A key is always an array of from 1 to 255
bytes, which may have any semantics at all.
Keys must be unique; no two distinct entries
in an SDR hash table may have the same key.
Any attempt to insert a duplicate entry will
be rejected.
All keys must be of the same length, and that
length must be declared at the time the hash
table is created. Invoking a hash table
function with a key that is shorter than the
declared length will have unpredictable
results.
Author: Scott Burleigh, JPL
Copyright (c) 2008 California Institute of Technology.
ALL RIGHTS RESERVED. U.S. Government Sponsorship
acknowledged.
*/
#ifndef _SDRHASH_H_
#define _SDRHASH_H_
#ifdef __cplusplus
extern "C" {
#endif
/* Functions for operating on hash tables in SDR. */
#define sdr_hash_create(sdr, keyLength, estNbrOfEntries, meanSearchLength) \
Sdr_hash_create(__FILE__, __LINE__, sdr, keyLength, estNbrOfEntries, \
meanSearchLength)
extern Object Sdr_hash_create(char *file, int line, Sdr sdr,
int keyLength, int estNbrOfEntries,
int meanSearchLength);
#define sdr_hash_insert(sdr, hash, key, value, entry) \
Sdr_hash_insert(__FILE__, __LINE__, sdr, hash, key, value, entry)
extern int Sdr_hash_insert(char *file, int line, Sdr sdr,
Object hash, char *key, Address value,
Object *entry);
#define sdr_hash_delete_entry(sdr, entry) \
Sdr_hash_delete_entry(__FILE__, __LINE__, sdr, entry)
extern int Sdr_hash_delete_entry(char *file, int line, Sdr sdr,
Object entry);
extern Address sdr_hash_entry_value(Sdr sdr,
Object hash, Object entry);
extern int sdr_hash_retrieve(Sdr sdr,
Object hash, char *key, Address *value,
Object *entry);
typedef void (*sdr_hash_callback)(Sdr sdr, Object hash,
char *key, Address value, void *args);
extern int sdr_hash_foreach(Sdr sdrv, Object hash,
sdr_hash_callback callback, void *args);
extern int sdr_hash_count(Sdr sdr,
Object hash);
#define sdr_hash_revise(sdr, hash, key, value) \
Sdr_hash_revise(__FILE__, __LINE__, sdr, hash, key, value)
extern int Sdr_hash_revise(char *file, int line, Sdr sdr,
Object hash, char *key, Address value);
#define sdr_hash_remove(sdr, hash, key, value) \
Sdr_hash_remove(__FILE__, __LINE__, sdr, hash, key, value)
extern int Sdr_hash_remove(char *file, int line, Sdr sdr,
Object hash, char *key, Address *value);
#define sdr_hash_destroy(sdr, hash) \
Sdr_hash_destroy(__FILE__, __LINE__, sdr, hash)
extern void Sdr_hash_destroy(char *file, int line, Sdr sdr,
Object hash);
#ifdef __cplusplus
}
#endif
#endif /* _SDRHASH_H_ */
|