SDO_List::insert

(^)

SDO_List::insert — Insertar en una lista

Descripción

void SDO_List::insert ( mixed $value [, int $index ] )

Advertencia

Esta función ha sido declarada EXPERIMENTAL. Su comportamiento, su nombre y la documentación que le acompaña puede cambiar sin previo aviso en futuras versiones de PHP. Use esta función bajo su propio riesgo.

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

Parámetros

value: El nuevo valor a insertar. Puede ser un primitivo o un SDO_DataObject.
index: La posición en la que insertar el nuevo elemento. Si este argumento no se especifica el nuevo valor será añadido al final.

Valores devueltos

None.

Errores/Excepciones

SDO_IndexOutOfBoundsException: Lanzada si el índice de la lista es menor que cero o mayor que el tamaño de la lista.
SDO_InvalidConversionException: Lanzada si el tipo del nuevo valor no coincide con el tipo de la lista (p.ej. el tipo de la propiedad polievaluada que la lista representa).