Looks up the entry with the specified key and return its value.

Syntax

#include <plhash.h>

void *PL_HashTableLookup(
  PLHashTable *ht,
  const void *key);

Parameters

The function has the following parameters:

ht

A pointer to the hash table in which to look up the entry specified by key.

key

A pointer to the key for the entry to look up.

Returns

The value of the entry with the specified key, or NULL if there is no such entry.

Description

If there is no entry with the specified key, PL_HashTableLookup returns NULL. This means that one cannot tell whether a NULL return value means the entry does not exist or the value of the entry is NULL. Keep this ambiguity in mind if you want to store NULL values in a hash table.