7.22 ADD_MEMBERプロシージャ
このプロシージャを使用して、既存のコレクションに新しいメンバーを追加します。指定されたコレクションが、カレント・アプリケーションIDの同じセッション内にカレント・ユーザー用として存在しないと、エラーが発生します。新しいメンバーの追加では、欠落したものは使用されないため、メンバーの順序番号が1,2,5,8である既存のコレクションの場合、新しいメンバーは順序番号9として追加されます。
構文
APEX_COLLECTION.ADD_MEMBER (
p_collection_name IN VARCHAR2,
p_c001 IN VARCHAR2 default null,
...
p_c050 IN VARCHAR2 default null,
p_n001 IN NUMBER default null,
p_n002 IN NUMBER default null,
p_n003 IN NUMBER default null,
p_n004 IN NUMBER default null,
p_n005 IN NUMBER default null,
p_d001 IN DATE default null,
p_d002 IN DATE default null,
p_d003 IN DATE default null,
p_d004 IN DATE default null,
p_d005 IN DATE default null,
p_clob001 IN CLOB default empty_clob(),
p_blob001 IN BLOB default empty_blob(),
p_xmltype001 IN XMLTYPE default null,
p_generate_md5 IN VARCHAR2 default 'NO');
パラメータ
注意:
4,000文字を超える文字属性は、4,000文字に切り捨てられます。
表7-1 ADD_MEMBERプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
既存のコレクションの名前。最大長は255バイトです。コレクション名は大/小文字が区別されず、大文字に変換されます。 |
|
追加するメンバーの属性値。最大長は4,000バイトです。4,000文字を超える文字属性は、4,000文字に切り捨てられます。 |
|
追加する数値属性の属性値。 |
|
日付属性の属性値。 |
|
4,000文字を超えるコレクション・メンバー属性には、p_clob001を使用します。 |
|
バイナリ・コレクション・メンバー属性には、p_blob001を使用します。 |
|
整形式XMLを格納するには、p_xmltype001を使用します。 |
|
有効な値には |
例
ADD_MEMBERプロシージャの例を次に示します。
APEX_COLLECTION.ADD_MEMBER(
p_collection_name => 'GROCERIES'
p_c001 => 'Grapes',
p_c002 => 'Imported',
p_n001 => 125,
p_d001 => sysdate );
END;
親トピック: APEX_COLLECTION