strm_dict_set_index()

Updated: May 06, 2022

Modify a dictionary entry by index, using a string

Synopsis:

#include <sys/strm.h>
strm_dict_t* strm_dict_set_index(strm_dict_t *dict,
                                 size_t index,
                                 const char *value)

Arguments:

dict
A dictionary handle.
index
The index of the entry to modify. The index is zero-based.
value
The new value of the entry.

Library:

libstrm

Description:

This function creates a new dictionary that is an exact replica of the one specified by dict, except that the value of the entry specified by index is replaced with value.

When the function succeeds, the original dictionary handle is destroyed and a handle to the new dictionary is returned.

Returns:

A handle to the new dictionary on success, or a null pointer on failure (if you provided an out-of-range index, errno is set to ESRCH).