Insert into a sequence

Descrierea

void SDO_Sequence::insert ( mixed $value [, int $sequenceIndex [, mixed $propertyIdentifier ]] )

Avertizare

Această funcție este EXPERIMENTALĂ. Comportamentul acestei funcții, denumirea sa și orice alte aspecte documentate în privința acestei funcții pot să fie modificate fără preaviz într-o versiune viitoare a PHP. Utilizați această funcție la propriul risc.

Insert a new element at a specified position in the sequence. All subsequent sequence items are moved up.

Parametri

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.

Valorile întoarse

None.

Erori/Excepții

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.