Modify a dictionary entry (using key-value shareable string objects)
#include <strm.h> strm_dict_t *strm_dict_set_rstr( strm_dict_t *dict, strm_string_t *key, strm_string_t *value );
libstrm
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.
A handle to the new dictionary object on success, or a null pointer on failure.
QNX Neutrino
Safety: | |
---|---|
Interrupt handler | No |
Signal handler | No |
Thread | Yes |