Chained hash table implementation

• typedef size_t hkey_t; doesn't seem right. Since hash has to be implemented by the client, the client must know exactly what hkey_t is. It would however make certain sense to use hkey_t throughout your code.

• It is very suspicious that data argument to remove has an extra level of indirection, compared to insert and lookup. Is it a typo?

• I'd recommend to allocate buckets with calloc instead of malloc. Then a cleanup loop of chtb_init can be replaced with a call to chtb_destroy, that is stating your intention explicitly.

• Since the linked_list.h code is not posted, it is impossible to reason about the rest of the functions (specifically, return codes). In general, it make sense to return more than just failure code (a pointer to an inserted node, maybe? - cf STL inserts).

The function pointers hash, destroy and compare are repeatedly used in a of couple places. It is time to turn them into typedefs:

typedef hkey_t (*hash_func)    (const void *key);
typedef void   (*destroy_func) (void *data);
typedef int    (*compare_func) (const void *fdata, const void *sdata);

Integer return codes can easily become a source of confusion and error. Take chtb_insert() for instance. It return 1, -1, and 0, where 0 seems to be the "successful" return. Now suppose someone (even yourself a few months from now) forgets about this and assumes the function is returning a boolean 0|1 value for failure and success, respectively. This person would probably use the function like this:

if (chtb_insert( htbl, ... ))
{
    // Yey! Insertion was successful
}

Only to later find out that his/her logic is going to behave the exact opposite way it was expected.

A better interface would be return a bool true or false (Include <stdbool.h> for that). Or, if you need more specific error handling, then define and enum type for error codes that are more involving than just success and failure. E.g.:

enum ht_error
{
    HT_ERROR_DUPLICATE_KEY,
    HT_ERROR_OUT_OF_MEMORY,
    ... etc ...
};

ht_error ht_function( ... );

Prefer to return early instead of nesting. This simplifies logic for the reader. For example, in the first lines of chtb_init() you have:

if( (chtb = malloc(sizeof *chtb)) != NULL ) {
    chtb->buckets = buckets;
    chtb->hash = hash;
    chtb->destroy = destroy;
    chtb->compare = compare;

You can get rid of a level of indentation for the whole function by just doing this:

if ( (chtb = malloc(sizeof *chtb)) == NULL ) {
    return NULL;
}

With C99, you can declare variables anywhere. This includes loop counters in for() loops. This is generally preferred, as it reduces scope. A variable with full function scope is somewhat like a mini-global.

I recommend checking your ChainedHashTable *chtb pointers with assert before dereferencing them. A valid hash table pointer is a precondition of every function, so you should enforce that.