SDO_Sequence::insert
(^)
SDO_Sequence::insert — Insert into a sequence
Description
SDO_Sequence::insert ( mixed $value [, int $sequenceIndex [, mixed $propertyIdentifier ]] ) : void
This function is EXPERIMENTAL. The behaviour of this function, its name, and surrounding documentation may change without notice in a future release of PHP. This function should be used at your own risk.
Insert a new element at a specified position in the sequence. All subsequent sequence items are moved up.
Parameters
-
value
-
The new value to be inserted. This can be either a primitive or an SDO_DataObject.
-
sequenceIndex
-
The position at which to insert the new element. Default is NULL, which results in the new value being appended to the sequence.
-
propertyIdentifier
-
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.
Return Values
None.
Errors/Exceptions
-
SDO_IndexOutOfBoundsException
-
Thrown if the sequence index is less than zero or greater than the size of the sequence.
-
SDO_InvalidConversionException
-
Thrown if the type of the new value cannot be juggled to match the type for the specified data object property.
© 1997–2020 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/sdo-sequence.insert.php