SDO_List::insert

(^)

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

Описание

SDO_List::insert ( mixed $value , int $index = ? ) : void

Внимание

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

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

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

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

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

Ничего.

Ошибки

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