strm_dict_key_get()

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

Synopsis:

#include <strm.h>

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

Arguments:

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

Library:

libstrm

Description:

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