strm_dict_key_delete()

Delete a dictionary entry (by key)

Synopsis:

#include <sys/strm.h>

strm_dict_t* strm_dict_key_delete(strm_dict_t *dict,
                                  char const *key)

Since:

BlackBerry 10.0.0

Arguments:

dict: A dictionary object handle.

key: The key of the entry to delete.

Library:

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

Description:

This function creates a new dictionary object that is an exact replica of the old object, except the entry specified by the key argument is deleted. The function returns a handle to the new dictionary object, or a null pointer on failure. On success, the original dictionary handle is destroyed.

Returns:

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