strm_dict_subtract()

Subtract one dictionary from another

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