(^)
SDO_List::insert — Вставляет в список
Эта функция является ЭКСПЕРИМЕНТАЛЬНОЙ. Поведение этой функции, ее имя и относящаяся к ней документация могут измениться в последующих версиях PHP без уведомления. Используйте эту функцию на свой страх и риск.
Вставляет новый элемент в указанную позицию в списке. Все последующие элементы списка перемещаются вверх.
value
Новое значение для вставки. Может быть либо примитив, либо SDO_DataObject.
index
Позиция, в которой нужно вставить новый элемент. Если этот аргумент не указан, будет добавлено новое значение.
Ничего.
SDO_IndexOutOfBoundsException
Выбрасывается исключение, если индекс списка меньше нуля или больше, чем размер списка.
SDO_InvalidConversionException
Выбрасывается исключение, если тип нового значения не соответствует типу для списка (например, тип многозначного свойства, которое представляет список)