SDO_List::insert
リストに挿入する
説明
void SDO_List::insert
( mixed $value
[, int $index
] )
警告この関数は、
実験的 なものです。この関数の動作・
名前・その他ドキュメントに書かれている事項は、予告なく、将来的な PHP
のリリースにおいて変更される可能性があります。
この関数は自己責任で使用してください。
リスト内の指定した位置に、新しい要素を挿入します。
リストのそれ以降の項目は、ひとつ後ろにずれます。
パラメータ
-
value
-
挿入される新しい値。
プリミティブ型あるいは SDO_DataObject のいずれかです。
-
index
-
新しい要素を挿入する位置。
指定しない場合は、新しい値は最後に追加されます。
エラー / 例外
-
SDO_IndexOutOfBoundsException
-
インデックスがゼロより小さい場合、あるいはインデックスが
リストのサイズより大きい場合にスローされます。
-
SDO_InvalidConversionException
-
新しい値の型がリストに使用できない場合
(例: 多くの値をとりうるプロパティ)
にスローされます。