strm_dict_set_rstr()

Modify a dictionary entry (using key-value shareable string objects)

Synopsis:

#include <strm.h>

strm_dict_t *strm_dict_set_rstr( strm_dict_t *dict,
                                 strm_string_t *key,
                                 strm_string_t *value );

Arguments:

dict
A dictionary object handle.
key
The key of the dictionary entry to add or modify.
value
The value of the dictionary entry to add or modify.

Library:

libstrm

Description:

The function strm_dict_set_rstr() creates a new dictionary object that is an exact replica of the dictionary object specified by the dict argument, except that the entry specified by the key and value arguments is added or modified. A handle to the new dictionary object is returned.

The original dictionary handle, and the handles to the key and value arguments are destroyed on success.

This function is equivalent to strm_dict_set(), except that it may be more efficient if you use clones of the same key handle repeatedly.

Returns:

A handle to the new dictionary object on success, or a null pointer on failure.

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes