hash_table.h

Go to the documentation of this file.

 
#ifndef CHASHTABLE_HASH_TABLE_H
#define CHASHTABLE_HASH_TABLE_H
 
typedef struct entry {
    int key;
    int value;
    struct entry *next;
} Entry;
 
typedef struct hash_table HashTable;
 
HashTable *hash_table_create(void);
 
bool hash_table_destroy(HashTable *table);
 
bool hash_table_insert(HashTable *table, int key, int value);
 
const Entry *hash_table_get(const HashTable *table, int key);
 
bool hash_table_delete(HashTable *table, int key);
 
bool hash_table_equal(const HashTable *table1, const HashTable *table2);
 
HashTable *hash_table_copy(const HashTable *table);
 
void hash_table_foreach(const HashTable *table, void (*callback)(int key, int value, void *), void *user_data);
 
bool hash_table_save(const HashTable *table, const char *filename);
 
typedef enum {
    HT_LOAD_OK = 0,               // Success
    HT_LOAD_ERROR_FILE_OPEN,      // Could not open the file
    HT_LOAD_ERROR_EMPTY,          // File is empty or header is unreadable
    HT_LOAD_ERROR_INVALID_HEADER, // Invalid file header prefix
    HT_LOAD_ERROR_MISSING_COUNT,  // Item count line is missing
    HT_LOAD_ERROR_MALFORMED_COUNT,// Failed to parse the item count
    HT_LOAD_ERROR_ALLOC_FAILED,   // Failed to allocate memory for the hash table
    HT_LOAD_ERROR_PREMATURE_EOF,  // File ended before all items were read
    HT_LOAD_ERROR_MALFORMED_LINE  // File contains malformed key-value pairs, or item count mismatch.
} HashTable_LoadError;
 
HashTable_LoadError hash_table_load(const char *filename, HashTable **out_table);
 
const char *hash_table_error_string(HashTable_LoadError error_code);
 
void hash_table_print(const HashTable *table, bool print_empty_buckets);
 
 
#endif //CHASHTABLE_HASH_TABLE_H