strm_dict_subtract()

Synopsis:

#include <strm.h>

strm_dict_t *strm_dict_subtract( strm_dict_t *left,
                                 strm_dict_t const *right );

Arguments:

left: A handle to the first dictionary object.
right: A handle to the second dictionary object.

Library:

libstrm

Description:

The function strm_dict_subtract() creates a replica of the left dictionary object and removes all those entries that have matching keys in the right object regardless of their value.

Note that the left dictionary object handle is consumed by this function, even on a failure, but the right is not (unless it's the same handle). If the same handle is passed for both arguments, this function returns an empty dictionary object, without dismantling the dictionary object referenced by the function arguments.

Returns:

A new handle to the resulting dictionary object on success, or a null pointer on failure.

Classification:

QNX Neutrino

Safety:
Interrupt handler	No
Signal handler	No
Thread	Yes