Insert a new item at position n in a PLIST_ARRAY node.
- Parameters
-
| node | the node of type PLIST_ARRAY |
| item | the new item to insert. The array is responsible for freeing item when it is no longer needed. |
| n | The 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.