summaryrefslogtreecommitdiffstats
path: root/docs/nspr/reference/pl_hashtableenumerateentries.rst
blob: ce77c8aad7a31ce54551fca81ca38dee80858911 (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
37
38
39
40
41
42
43
44
45
46
PL_HashTableEnumerateEntries
============================

Enumerates all the entries in the hash table, invoking a specified
function on each entry.


Syntax
------

.. code::

   #include <plhash.h>

   PRIntn PL_HashTableEnumerateEntries(
     PLHashTable *ht,
     PLHashEnumerator f,
     void *arg);


Parameters
~~~~~~~~~~

The function has the following parameters:

``ht``
   A pointer to the hash table whose entries are to be enumerated.
``f``
   Function to be applied to each entry.
``arg``
   Argument for function ``f``.


Returns
~~~~~~~

The number of entries enumerated.


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

The entries are enumerated in an unspecified order. For each entry, the
enumerator function is invoked with the entry, the index (in the
sequence of enumeration, starting from 0) of the entry, and arg as
arguments.