PL_HashTableAdd

将一个新的条目（包含指定的键和值）添加到哈希表中。

语法

#include <plhash.h>

PLHashEntry *PL_HashTableAdd(
  PLHashTable *ht,
  const void *key,
  void *value);

参数

该函数具有以下参数

ht

指向要添加条目的哈希表的指针。

key

指向要添加的条目的键的指针。

value

指向要添加的条目的值的指针。

返回值

指向新条目的指针。

描述

将一个新的条目（包含指定的键和值）添加到哈希表中。

如果表中已经存在具有相同键的条目，则会使用 HT_FREE_VALUE 标志调用 freeEntry 函数。您可以编写自己的 freeEntry 函数来释放指定条目的值（如果需要释放旧值）。默认的 freeEntry 函数不会释放条目的值。

PL_HashTableAdd 如果没有足够的内存来创建新条目，则返回 NULL。如果表过载，它会将桶的数量加倍。