strm_dict_set()

Modify a dictionary entry (using key-value strings)

Synopsis:

#include <sys/strm.h>
 
strm_dict_t* strm_dict_set(strm_dict_t *dict,
                           const char *key,
                           const char *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.

An entry is added to the dictionary when there is no dictionary object that exists with key as its key. When such a dictionary object does exist, its value is replaced with value.

A handle to the new dictionary object is returned. The original dictionary handle is destroyed on success.

Returns:

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

Last modified: 2014-09-30



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus