mirror of
https://github.com/boostorg/build.git
synced 2026-02-16 13:22:11 +00:00
66 lines
1.8 KiB
C
66 lines
1.8 KiB
C
/*
|
|
* Copyright 1993, 1995 Christopher Seiwald.
|
|
*
|
|
* This file is part of Jam - see jam.c for Copyright information.
|
|
*/
|
|
|
|
/*
|
|
* hash.h - simple in-memory hashing routines
|
|
*/
|
|
|
|
#ifndef BOOST_JAM_HASH_H
|
|
#define BOOST_JAM_HASH_H
|
|
|
|
/*
|
|
* An opaque struct representing an item in the
|
|
* hash table. The first element of every struct
|
|
* stored in the table must be an OBJECT * which
|
|
* is treated as the key.
|
|
*/
|
|
typedef struct hashdata HASHDATA;
|
|
|
|
/*
|
|
* hashinit() - initialize a hash table, returning a handle.
|
|
* datalen is the size of the items. name is used for debugging.
|
|
*/
|
|
struct hash * hashinit ( int datalen, const char * name );
|
|
|
|
/*
|
|
* hashdone() - free a hash table, given its handle
|
|
*/
|
|
void hashdone ( struct hash * hp );
|
|
|
|
/*
|
|
* hashenumerate() - call f(i, data) on each item, i in the hash
|
|
* table. The order of the items is unspecified.
|
|
*/
|
|
void hashenumerate( struct hash * hp, void (* f)( void *, void * ), void * data );
|
|
|
|
/*
|
|
* hash_insert() - insert a new item in a hash table, or return an
|
|
* existing one.
|
|
*
|
|
* Preconditions:
|
|
* - hp must be a hash table created by hashinit
|
|
* - key must be an object created by object_new
|
|
*
|
|
* Postconditions:
|
|
* - if the key does not already exist in the hash
|
|
* table, *found == 0 and the result will be a
|
|
* pointer to an uninitialized item. The key
|
|
* of the new item must be set to a value equal to
|
|
* key before any further operations on the
|
|
* hash table except hashdone.
|
|
* - if the key is present then *found == 1 and
|
|
* the result is a pointer to the existing
|
|
* record.
|
|
*/
|
|
HASHDATA * hash_insert ( struct hash * hp, OBJECT * key, int * found );
|
|
|
|
/*
|
|
* hash_find() - find a record in the table or NULL if none exists
|
|
*/
|
|
HASHDATA * hash_find ( struct hash * hp, OBJECT * key );
|
|
|
|
#endif
|