strm_dict_find_rstr()

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

Synopsis:

#include <strm.h>

const strm_string_t *strm_dict_find_rstr( 
                                const strm_dict_t *dict,
                                const char *key );

Arguments:

dict
A handle to a dictionary object.
key
The name of the dictionary entry.

Library:

libstrm

Description:

The function strm_dict_find_rstr() finds the dictionary entry specified by the key argument, returning a handle to the entry's value. The returned shareable string object handle is owned by the dictionary, and remains valid until the dictionary handle is destroyed.

Returns:

A handle to the value of the dictionary entry specified by the key parameter if the 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