The dictionary object type


#include <strm.h>

typedef struct strm_dict strm_dict_t;


The structure strm_dict_t is a private data type representing a dictionary object.

Dictionaries cannot be modified; they can only be created and destroyed. For example, the function strm_dict_set() takes a dictionary object handle, destroys it, creates a replica of the dictionary object and returns a new handle to it. It's equivalent to calling strm_string_destroy() and strm_string_make(), except that it may reuse the original object's memory.

Different dictionary object handles may be represented by identical pointers. You should not compare handles. Regardless of how the handles are represented internally, you have to call strm_dict_destroy() separately for each handle to properly dispose of any resources associated with it.

Use the following functions to manipulate dictionary objects:


QNX Neutrino