15.20 DELETE_MEMBERSプロシージャ

属性番号で指定した属性が指定した値と等しい場合に、指定された名前付きコレクションからすべてのメンバーを削除します。

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

指定した属性番号が無効であるか、または1から50の範囲外であると、エラーが発生します。

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

構文

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

パラメータ

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