strm_dict_key_get()

#include <sys/strm.h>
 

const char* strm_dict_key_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 finds the key of the (n + 1)th entry in the specified dictionary and returns it as a null-terminated string. For example, if n is 3, the key 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.