SDO_Sequence::insert

(^)

SDO_Sequence::insert Ajoute dans une séquence

Description

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

Cette fonction est EXPERIMENTALE. Le comportement de cette fonction, son nom, et toute la documentation autour de cette fonction peut changer sans préavis dans une prochaine version de PHP. Cette fonction doit être utilisée à vos risques et périls.

Insère un nouvel élément à une position spécifiée dans la séquence. Tous les items de la séquence suivant sont déplacés vers le haut.

Liste de paramètres

value

La nouvelle valeur à être insérée. Cela peut être soit une primitive soit un SDO_DataObject.

sequenceIndex

La position à laquelle il faut insérer le nouvel élément. La valeur par défaut est NULL, ainsi la nouvelle valeur sera ajoutée à la suite de la séquence.

propertyIdentifier

Soit une propriété index, name ou un SDO_Model_Property, utilisé pour identifier une propriété dans la séquence correspondant à SDO_DataObject. Une valeur de NULL signifie un texte non structuré.

Valeurs de retour

Aucune.

Erreurs / Exceptions

SDO_IndexOutOfBoundsException

Émis si l'index de la séquence est inférieur à zéro ou supérieur à la taille de la séquence.

SDO_InvalidConversionException

Émis si le type de la nouvelle valeur ne correspond pas avec le type pour la propriété de l'objet de données spécifié.