Forum und email

SDO_List::insert

(No version information available, might be only in CVS)

SDO_List::insert — Insert into a list

Description

void SDO_List::insert ( mixed $value [, int $index ] )
Warning

Varoitus! Tämä funktio on EKSPERIMENTAALINEN. Tämän funktion ominaisuudet, käyttäytyminen, parametrit ja nimi voivat muuttua varoituksetta seuraavissa PHP versioissa.

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

Parameters

value

The new value to be inserted. This can be either a primitive or an SDO_DataObject.

index

The position at which to insert the new element. If this argument is not specified then the new value will be appended.

Return values

None.

Errors/Exceptions

SDO_IndexOutOfBoundsException

Thrown if the list index is less than zero or greater than the size of the list.

SDO_InvalidConversionException

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).