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;
親トピック: APEX_COLLECTION