SDO_Sequence::insert
(^)
SDO_Sequence::insert — Ajoute dans une séquence
Description
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
NULLsignifie 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é.
add a note
