strm_dict_key_delete()

Delete a dictionary entry (by key)

Synopsis:

#include <strm.h>

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

Arguments:

dict
A dictionary object handle.
key
The key of the entry to delete.

Library:

libstrm

Description:

The function strm_dict_key_delete() 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 for the new dictionary object, or a null pointer on failure. On success, the original dictionary handle is destroyed.

Returns:

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

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes