strm_dict_value_rstr()

Find the value of a dictionary entry (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 the 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