rbhash_insert3
Insert a new entry into an rbhash
Usage
#include <roy.h>
void rbhash_insert (RBHash *hash, void *entry, RBuf *key);
Overview
Inserts a new entry into a hash table. The entry structure is defined by the user, and should contain the macro 'RBHASH_HEADER'. See rbhash(3) for information on how to create a compatible RBHashEntry structure.
This function sets key as the key for entry; the equivalent of calling rbhash_entry_setkey(3). The key is stored using an RBuf * pointer within the RBHASH_HEADER; no copy of the RBuf itself is made.
Return value
This function doesn't reutrn a value.
Duplicate entries
If an entry is inserted into the hash table with a key of an entry that already exists in the hash table, they will both be added and no error condition will exist. Any calls thereafter to rbhash_lookup(3) will return the first entry inserted with that key.
If you do not wish to have multiple entries with the same key, you must do a rbhash_lookup(3) prior to inserting the new entry.
Releases
2 releases since Debian 3.0 (Woody); the text changed 1 time.