This function is EXPERIMENTAL. The behaviour of this function, the name of this function, and anything else documented about this function may change without notice in a future release of PHP. Use this function at your own risk.
Insert a new element at a specified position in the list. All subsequent list items are moved up.
The new value to be inserted. This can be either a primitive or an SDO_DataObject.
The position at which to insert the new element. If this argument is not specified then the new value will be appended.
Thrown if the list index is less than zero or greater than the size of the list.
Thrown if the type of the new value does not match the type for the list (e.g. the type of the many-valued property that the list represents).