strm_dict_value_get()

Find the value of a dictionary entry (returns a string)

Synopsis:

#include <strm.h>

const char *strm_dict_value_get( const strm_dict_t *dict,
                                 size_t n );

Arguments:

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

Library:

libstrm

Description:

The function strm_dict_value_get() returns the value of the (n+1)th entry in the dictionary as a null-terminated string. For example, if the n is 3, the value 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.

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes