SDO_Sequence::insert

(^)

SDO_Sequence::insert シーケンスに挿入する

説明

SDO_Sequence::insert ( mixed $value [, int $sequenceIndex [, mixed $propertyIdentifier ]] ) : void
警告

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

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

パラメータ

value

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

sequenceIndex

新しい要素を挿入する位置。デフォルトは NULL で、 この場合は新しい値がシーケンスの最後に追加されます。

propertyIdentifier

プロパティのインデックス、プロパティ名あるいは SDO_Model_Property シーケンスに対応する SDO_DataObject プロパティを指定するために 使用します。NULL は、非構造化テキストを意味します。

返り値

なし。

エラー / 例外

SDO_IndexOutOfBoundsException

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

SDO_InvalidConversionException

新しい値の型が、指定されたデータオブジェクトプロパティの型に 対応していない場合にスローされます。