strm_dict_compare()

#include <sys/strm.h>
 

strm_dict_t* strm_dict_compare(strm_dict_t *newdict,
                               strm_dict_t const *olddict)

Since:

BlackBerry 10.0.0

Arguments:

newdict

A handle to the newer version of a dictionary object.

olddict

A handle to the older version of a dictionary object.

Library:

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

Description:

This function compares two dictionaries. It creates a replica of newdict and removes all those entries that also exist in olddict and have the same value. In other words, if olddict is the older version of some dictionary and newdict is the newer version, the resulting dictionary contains the entries that were changed or added, but not the ones that were left alone or deleted.

This function destroys the newdict handle, even on a failure. If the same handle is passed for both arguments, this function destroys it and returns a new handle to an empty dictionary object.

Returns:

A handle to the dictionary object containing the result of the comparison, or a null pointer on failure.