10.44 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 );

パラメータ

表10-21 MOVE_MEMBER_UPのパラメータ

パラメータ 説明
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;