プライマリ・コンテンツに移動

Oracle® Application Express APIリファレンス リリース5.1 E85937-02 |
| 目次 | 索引

前 | 次 |

# 5.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);

パラメータ

表5-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;

参照:

- DELETE_ALL_COLLECTIONS_SESSIONプロシージャ

- DELETE_ALL_COLLECTIONSプロシージャ

- DELETE_COLLECTIONプロシージャ

- 「DELETE_MEMBERプロシージャ」