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.