MOVE_MEMBER_UPプロシージャ

指定した名前付きコレクションの特定のメンバーの順序番号を1つ上げて(1を足して)調整し、順序番号と、その置換番号とを入れ替えます。たとえば、2は3になり、3は2になります。

指定した名前のコレクションが、同じセッションのカレント・ユーザー用およびカレント・アプリケーションID用として存在しないと、アプリケーション・エラーが発生します。

順序番号p_seqで指定したメンバーが存在しないと、アプリケーション・エラーが発生します。

順序番号p_seqで指定したメンバーがコレクションで最も大きい順序であっても、アプリケーション・エラーは戻されません。

構文

APEX_COLLECTION.MOVE_MEMBER_UP (
    p_collection_name   IN VARCHAR2,
    p_seq               IN NUMBER )

パラメータ

パラメータ	説明
`p_collection_name`	コレクションの名前。最大長は255バイトです。コレクション名は大/小文字が区別されず、大文字に変換されます。カレント・ユーザーの指定した名前のこのコレクションが、同じセッションに存在しないと、エラーが戻されます。
`p_seq`	1つ上げて移動させるコレクション・メンバーの順序番号を指定します。

例

この例では、EMPLOYEESコレクションのメンバーの位置を1つ上げます。この例では、順序番号5は順序番号6になり、順序番号6は順序番号5になります。

BEGIN
    APEX_COLLECTION.MOVE_MEMBER_UP( 
        p_collection_name => 'EMPLOYEES',
        p_seq => '5' );
END;