SDO_List::insert

(^)

SDO_List::insert Вставляет в список

Описание

SDO_List::insert ( mixed $value , int $index = ? ) : void
Внимание

Эта функция является ЭКСПЕРИМЕНТАЛЬНОЙ. Поведение этой функции, ее имя и относящаяся к ней документация могут измениться в последующих версиях PHP без уведомления. Используйте эту функцию на свой страх и риск.

Вставляет новый элемент в указанную позицию в списке. Все последующие элементы списка перемещаются вверх.

Список параметров

value

Новое значение для вставки. Может быть либо примитив, либо SDO_DataObject.

index

Позиция, в которой нужно вставить новый элемент. Если этот аргумент не указан, будет добавлено новое значение.

Возвращаемые значения

Ничего.

Ошибки

SDO_IndexOutOfBoundsException

Выбрасывается исключение, если индекс списка меньше нуля или больше, чем размер списка.

SDO_InvalidConversionException

Выбрасывается исключение, если тип нового значения не соответствует типу для списка (например, тип многозначного свойства, которое представляет список)