SDO_Sequence::insert
(^)
SDO_Sequence::insert — Ajoute dans une séquence
Description
Cette fonction est EXPERIMENTALE. Cela signifie que le comportement de cette fonction, son nom et, concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS ! Soyez-en conscient, et utilisez cette fonction à 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é.