strm_dict_value_rstr()

#include <sys/strm.h>
 

const strm_string_t* strm_dict_value_rstr(const strm_dict_t *dict,
                                          size_t n)

Since:

BlackBerry 10.0.0

Arguments:

dict

A dictionary object handle.

n

The 0-based index of the entry whose key is returned.

Library:

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

Description:

This function finds the (n + 1)th entry in the dictionary, and returns a handle to shareable string object containing the entry's value. For example, if n is 3, a handle to a shareable string object containing the value of the fourth entry is returned. The returned string handle is owned by the dictionary object, and remains valid until the dictionary handle is destroyed.

Returns:

A shareable string object handle to the key of the specified entry if it's found, or a null pointer if it isn't found.