strm_dict_subtract()

#include <sys/strm.h>
 

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

Since:

BlackBerry 10.0.0

Arguments:

left

A handle to the first dictionary object.

right

A handle to the second dictionary object.

Library:

libstrm (For the qcc command, use the -l mrndclient option to link against this library)

Description:

This function 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. If the same handle is passed for both arguments, this function destroys that handle and returns a new handle to an empty dictionary object.

Returns:

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