libplist  2.8.0
API Documentation - Return to Homepage

◆ plist_array_insert_item()

PLIST_API plist_err_t plist_array_insert_item ( plist_t node,
plist_t item,
uint32_t n )

Insert a new item at position n in a PLIST_ARRAY node.

Parameters
nodethe node of type PLIST_ARRAY
itemthe new item to insert. The array is responsible for freeing item when it is no longer needed.
nThe position at which the node will be stored. Range is [0, array_size[.
Returns
  • PLIST_ERR_SUCCESS on success.
  • PLIST_ERR_INVALID_ARG if node is not an array, item is NULL, item is already attached to a parent, or n is outside the valid insertion range.
  • PLIST_ERR_NO_MEM if memory allocation failed while inserting the item.
  • PLIST_ERR_UNKNOWN if an unexpected internal error occurred.