pips_multimap_add

Map a key to a JSON object

Synopsis:

#include <pips/multimap.h>

int pips_multimap_add_json(pips_multimap_t *multimap,
                           const char *key,
                           const char *json_data)

Arguments:

multimap: The multimap instance in which the new mapping (item) is being created
key: The key to assign to the mapping
json_data: A JSON object encoded as a NULL-terminated character string

Library:

pips-client

Description:

This function creates a mapping in the current multimap instance by associating a JSON object with the given key. The mapping is created only if the given key is not already mapped to another value, so this function cannot be used to update a key's value, only to create a new mapping.

Returns:

0: The mapping was created successfully

-1: An error prevented the creation of the new mapping (errno is set)

Errors:

EEXIST: The multimap already contains a mapping for the given key.
EINVAL: The multimap instance is not valid.
ENOMEM: There was not enough memory to allocate a new mapping.