void SDO_Sequence::insert ( mixed value [, int sequenceIndex [, mixed propertyIdentifier]] )
Avertissement
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é.