SDO_Sequence::insert

(^)

SDO_Sequence::insert Insertar en una secuencia

Descripción

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

Esta función ha sido declarada EXPERIMENTAL. Su funcionamiento, nombre y la documentación que le acompaña puede cambiar sin previo aviso en futuras versiones de PHP. Utilícela bajo su propia responsabilidad.

Inserta un nuevo elemento en la posición especificada de la secuencia. Todos los elementos subsiguientes son movidos hacia arriba.

Parámetros

value

El nuevo valor a insertar. Esto puede ser un primitivo o un SDO_DataObject.

sequenceIndex

La posición en la que insertar el nuevo elemento. Por imisión es NULL, lo que resulta en que el nuevo valor es añadido al final de la secuencia.

propertyIdentifier

Un índice de propiedad, un nombre de propiedada o un SDO_Model_Property, usado para identificar una propiedad en el SDO_DataObject correspondiente de la secuencia. Un valor de NULL significa texto no estructurado.

Valores devueltos

None.

Errores/Excepciones

SDO_IndexOutOfBoundsException

Lanzada si el índice de la secuencia es menor que cero o mayor que el tamaño de la secuencia.

SDO_InvalidConversionException

Lanzada si el tipo del nuevo valor no coincide con el tipo de la propiedad especificada del objeto de datos.