strm_dict_value_get()

Find the value of a dictionary entry based on the entry's index (returns a string)

Synopsis:

#include <sys/strm.h>
 
const char* strm_dict_value_get(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 returns the value of the (n + 1)th entry in the dictionary as a null-terminated string. For example, if n is 3, the value of the fourth entry is returned. The returned string is owned by the dictionary object, and remains valid until the dictionary handle is destroyed.

Returns:

The specified key on success, or a null pointer on failure.