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

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

前 | 次 |

# 5.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文字に切り捨てられます。

表5-1 ADD_MEMBERプロシージャのパラメータ

パラメータ | 説明
--- | ---
`p_collection_name` | 既存のコレクションの名前。最大長は255バイトです。コレクション名は大/小文字が区別されず、大文字に変換されます。
`p_c001からp_c050` | 追加するメンバーの属性値。最大長は4,000バイトです。4,000文字を超える文字属性は、4,000文字に切り捨てられます。
`p_n001からp_n005` | 追加する数値属性の属性値。
`p_d001`から`p_d005` | 日付属性の属性値。
`p_clob001` | 4,000文字を超えるコレクション・メンバー属性には、p_clob001を使用します。
`p_blob001` | バイナリ・コレクション・メンバー属性には、p_blob001を使用します。
`p_xmltype001` | 整形式XMLを格納するには、p_xmltype001を使用します。
`p_generate_md5` | 有効な値には`YES`と`NO`が含まれます。`YES`の場合、コレクション・メンバーのデータのメッセージ・ダイジェストが計算されます。このパラメータは、コレクション・メンバーのMD5を別のメンバーと比較する場合か、そのメンバーが変更されたかどうかを確認する場合に使用します。

例

ADD_MEMBERプロシージャの例を次に示します。

    APEX_COLLECTION.ADD_MEMBER(
            p_collection_name => 'GROCERIES'
            p_c001            => 'Grapes',
            p_c002            => 'Imported',
            p_n001            => 125,
            p_d001            => sysdate );
    END;

参照:

- 「GET_MEMBER_MD5ファンクション」

- 「ADD_MEMBERファンクション」

- 「ADD_MEMBERSプロシージャ」