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