summaryrefslogtreecommitdiffstats
path: root/docs/nspr/reference/plhashentry.rst
blob: ea11ac34396b8f6d568b3ddcf892743038d6df39 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
Syntax
------

.. code::

   #include <plhash.h>

   typedef struct PLHashEntry PLHashEntry;


Description
-----------

``PLHashEntry`` is a structure that represents an entry in the hash
table. An entry has a key and a value, represented by the following
fields in the ``PLHashEntry`` structure.

.. code::

   const void *key;
   void *value;

The key field is a pointer to an opaque key. The value field is a
pointer to an opaque value. If the key of an entry is an integral value
that can fit into a ``void *`` pointer, you can just cast the key itself
to ``void *`` and store it in the key field. Similarly, if the value of
an entry is an integral value that can fit into a ``void *`` pointer,
you can cast the value itself to ``void *`` and store it in the value
field.

.. warning::

   **Warning**: There are other fields in the ``PLHashEntry`` structure
   besides key and value. These fields are for use by the hash table
   library functions and the user should not tamper with them.