strm_dict_key_rstr()

Find the key of a dictionary entry (returns a shareable string object handle)

Synopsis:

#include <strm.h>

const strm_string_t *strm_dict_key_rstr( const strm_dict_t *dict,
                                         size_t n );

Arguments:

dict
A handle to a dictionary object.
n
The 0-based index of the entry whose key is returned.

Library:

libstrm

Description:

The function strm_dict_key_rstr() 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 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.

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes