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 sequence. All subsequent sequence 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. Default is NULL, which results in the new value being appended to the sequence.
Either a property index, a property name, or an SDO_Model_Property, used to identify a property in the sequence's corresponding SDO_DataObject. A value of NULL signifies unstructured text.
Thrown if the sequence index is less than zero or greater than the size of the sequence.
Thrown if the type of the new value cannot be juggled to match the type for the specified data object property.