strm_dict_value

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

Synopsis:

#include <strm.h>

const strm_string_t *strm_dict_value_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 value is returned.

Library:

libstrm

Description:

The function strm_dict_value_rstr() 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 the entry is found, or a null pointer if it isn't found.

Classification:

QNX Neutrino

Safety:
Interrupt handler	No
Signal handler	No
Thread	Yes