strm_dict_set_rstr()

#include <sys/strm.h>
 

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

Since:

BlackBerry 10.0.0

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 (For the qcc command, use the -l mrndclient option to link against this library)

Description:

This function 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.