strm_dict_key_rstr()

#include <sys/strm.h>
 

const strm_string_t* strm_dict_key_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 specified dictionary and returns a handle to the entry's key. For example, if n is 3, a handle to the key of the fourth entry is returned. The returned shareable string object handle is owned by the dictionary, 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.