libplist  2.8.0
API Documentation - Return to Homepage

◆ plist_dict_remove_item()

PLIST_API plist_err_t plist_dict_remove_item ( plist_t node,
const char * key )

Remove an existing position in a PLIST_DICT node.

Removed position will be freed using plist_free

Parameters
nodethe node of type PLIST_DICT
keyThe identifier of the item to remove
Returns
  • PLIST_ERR_SUCCESS on success.
  • PLIST_ERR_INVALID_ARG if node is not a dictionary, key is NULL, or no item with the given key exists.
  • PLIST_ERR_UNKNOWN if an unexpected internal error occurred while removing the item.