VG3_hash_list()

Listing entries of a hash: return next key.

SYNTAX

const void * VG3_hash_list(struct vg3_hash *hhash, void **vpos, size_t *keysize)

FUNCTION PARAMETERS

hhash	Hash
vpos	For passing and returning actual position pointer
keysize	Size of the key in bytes

RETURN VALUE

Returns next key.

DESCRIPTION

Listing entries of a hash: return next key. This function allows to iterate a hash until the position pointer vpos returns NULL.

EXAMPLE

Listing of a hash:

  struct vg3_hash *hash = VG3_hash_new();
  void *vpos;
  const char *key;
  size_t keysize;

  [... setting hash ...]

  vpos = NULL;
  for (key = VG3_hash_list(hash, &vpos, &keysize); vpos != NULL; key = VG3_hash_list(hash, &vpos, &keysize)) {
    printf("- %.*s\n", (int)keysize, key);
    vpos = VG3_hash_del(hash, key, keysize);  // remove entry
  }