15.23 MOVE_MEMBER_DOWNプロシージャ
指定した名前付きコレクションの特定のメンバーの順序番号を1つ下げて(1を引いて)調整し、順序番号と、その置換番号とを入れ替えます。たとえば、3は2になり、2は3になります。
指定した名前のコレクションが、同じセッションのカレント・ユーザー用およびカレント・アプリケーションID用として存在しないと、アプリケーション・エラーが発生します。
順序番号p_seq
で指定したメンバーが存在しないと、アプリケーション・エラーが発生します。
順序番号p_seq
で指定したメンバーがコレクションで最も小さい順序であっても、アプリケーション・エラーは戻されません。
構文
APEX_COLLECTION.MOVE_MEMBER_DOWN (
p_collection_name IN VARCHAR2,
p_seq IN NUMBER )
パラメータ
パラメータ | 説明 |
---|---|
p_collection_name |
コレクションの名前。最大長は255バイトです。コレクション名は大/小文字が区別されず、大文字に変換されます。カレント・ユーザーの指定した名前のこのコレクションが、同じセッションに存在しないと、エラーが戻されます。 |
p_seq |
1つ下げて移動させるコレクション・メンバーの順序番号を指定します。 |
例
この例は、EMPLOYEES
コレクションのメンバーの位置を1つ下げる方法を示しています。この例を実行した後、順序番号5
は順序番号4
になり、順序番号4
は順序番号5
になります。
BEGIN
APEX_COLLECTION.MOVE_MEMBER_DOWN(
p_collection_name => 'EMPLOYEES',
p_seq => '5' );
END;
親トピック: APEX_COLLECTION