strm_dict_find_rstr()

#include <sys/strm.h>
 

const strm_string_t* strm_dict_find_rstr(const strm_dict_t *dict,
                                         const char *key)

Since:

BlackBerry 10.0.0

Arguments:

dict

A dictionary object handle.

key

The name of the dictionary entry.

Library:

libstrm (For the qcc command, use the -l mrndclient option to link against this library)

Description:

This function finds the dictionary entry specified by the key argument, returning a handle to the entry's value. The returned shareable string object handle is owned by the dictionary, and remains valid until the dictionary handle is destroyed.

You can clone the returned handle to have a handle that exists independently of the dictionary until you decide to destroy it.

Returns:

A handle to the value of the dictionary entry specified by the key parameter if the the entry is found, or a null pointer if it isn't found.