mozilla
Your Search Results

    PR_HashTableAdd

    « NSPR API Reference « Hash_Tables

    Add a new entry with the specified key and value to the hash table.

    Syntax

    #include <plhash.h>
    
    PLHashEntry *PL_HashTableAdd(
      PLHashTable *ht, 
      const void *key, 
      void *value);
    

    Parameters

    The function has the following parameters:

    ht
    A pointer to the the hash table to which to add the entry.
    key
    A pointer to the key for the entry to be added.
    value
    A pointer to the value for the entry to be added.

    Returns

    A pointer to the new entry.

    Description

    Add a new entry with the specified key and value to the hash table.

    If an entry with the same key already exists in the table, the freeEntry function is invoked with the HT_FREE_VALUE flag. You can write your freeEntry function to free the value of the specified entry if the old value should be freed. The default freeEntry function does not free the value of the entry.

    PL_HashTableAdd returns NULL if there is not enough memory to create a new entry. It doubles the number of buckets if the table is overloaded.

    Document Tags and Contributors

    Contributors to this page: Dholbert, Rappo
    Last updated by: Dholbert,