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;