SDO_List::insert

(^)

SDO_List::insert — リストに挿入する

説明

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

この関数は、 実験的 なものです。この関数の動作・ 名前・その他ドキュメントに書かれている事項は、予告なく、将来的な PHP のリリースにおいて変更される可能性があります。 この関数は自己責任で使用してください。

リスト内の指定した位置に、新しい要素を挿入します。 リストのそれ以降の項目は、ひとつ後ろにずれます。

パラメータ

value

挿入される新しい値。 プリミティブ型あるいは SDO_DataObject のいずれかです。

index

新しい要素を挿入する位置。 指定しない場合は、新しい値は最後に追加されます。

返り値

なし。

エラー / 例外

SDO_IndexOutOfBoundsException

インデックスがゼロより小さい場合、あるいはインデックスが リストのサイズより大きい場合にスローされます。

SDO_InvalidConversionException

新しい値の型がリストに使用できない場合 (例: 多くの値をとりうるプロパティ) にスローされます。