Dictionary Object APIDictionary Object API Parent topic: Dictionary Object API

strm_dict_set_index()

Updated: October 28, 2024

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).

Parent topic: Dictionary Object API