PiPS Client APIpips_multimap_t Parent topic: pips_multimap_t

pips_multimap_get_item()

Updated: October 28, 2024

Get a named item from a multimap

Synopsis:

#include <pips/multimap.h>
pips_multimap_item_t* pips_multimap_get_item(pips_multimap_t *multimap,
                                             const char *key)

Arguments:

multimap
A pointer to the multimap from which to get the item
key
A string containing the key of the item being retrieved

Library:

pips-client

Returns:

On success, a pointer to the multimap item. On error, NULL (errno is set).

Errors:

  • EINVAL: The multimap pointer is invalid.
  • ENOENT: There's no entry with the given key in the multimap.
Parent topic: pips_multimap_t