DELETE_MEMBERSプロシージャ

9.40 DELETE_MEMBERSプロシージャ

このプロシージャを使用して、属性番号で指定した属性が特定の値と等しい場合に、指定した名前付きコレクションからすべてのメンバーを削除します。名前付きコレクションが、カレント・アプリケーションIDのカレント・セッション内に同じユーザー用として存在しないと、アプリケーション・エラーが発生します。指定した属性番号が無効であるか、または1から50の範囲外であると、エラーが発生します。

指定した属性値がnullの場合、名前付きコレクションのメンバーのうち、属性(p_attr_numberで指定)がnullであるすべてのメンバーが削除されます。

構文

APEX_COLLECTION.DELETE_MEMBERS (
    p_collection_name IN VARCHAR2,
    p_attr_number     IN VARCHAR2,
    p_attr_value      IN VARCHAR2);

パラメータ

表9-17 DELETE_MEMBERSのパラメータ

パラメータ	説明
`p_collection_name`	指定したメンバーを削除するコレクションの名前。最大長は255文字です。コレクション名は大/小文字が区別されず、大文字に変換されます。このコレクションが、同じセッションにカレント・ユーザー用として存在しないと、エラーが戻されます。
`p_attr_number`	削除のために指定した属性値との一致に使用されるメンバー属性の属性番号。有効な値は、1から50およびnullです。
`p_attr_value`	削除のための一致に使用されるメンバー属性の属性値。最大長は4,000バイトです。これよりも大きいと、属性値は4,000バイトに切り捨てられます。

例

次の例では、5番目の文字属性がAPPLEである場合に、GROCERIESというコレクションのすべてのメンバーが削除されます。

Begin
    apex_collection.delete_members( 
        p_collection_name => 'GROCERIES'
        p_attr_number     => 5,
        p_attr_value      => 'APPLE' );
    Commit;
End;

参照:

親トピック: APEX_COLLECTION