7.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);
パラメータ
表7-17 DELETE_MEMBERSのパラメータ
パラメータ | 説明 |
---|---|
|
指定したメンバーを削除するコレクションの名前。最大長は255文字です。コレクション名は大/小文字が区別されず、大文字に変換されます。このコレクションが、同じセッションにカレント・ユーザー用として存在しないと、エラーが戻されます。 |
|
削除のために指定した属性値との一致に使用されるメンバー属性の属性番号。有効な値は、1から50およびnullです。 |
|
削除のための一致に使用されるメンバー属性の属性値。最大長は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