7.56 UPDATE_MEMBER_ATTRIBUTEプロシージャのシグネチャ5

特定の名前付きコレクション内の指定したNUMBERメンバー属性を更新します。指定した名前のコレクションが、同じセッションのカレント・ユーザー用およびカレント・アプリケーションID用として存在しないと、アプリケーション・エラーが発生します。順序番号p_seqで指定したメンバーが存在しないと、アプリケーション・エラーが発生します。指定した属性番号が無効であるか、または有効な範囲(現在、NUMBERでは1から5のみ)の外であると、エラーが発生します。

構文

APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
    p_collection_name IN VARCHAR2,
    p_seq IN NUMBER,
    p_attr_number IN NUMBER,
    p_number_value  IN NUMBER);

パラメータ

注意:

4,000文字を超える文字属性は、4,000文字に切り捨てられます。また、追加されるメンバーの数は、1番目の配列内の要素の数に基づきます。

表7-32 UPDATE_MEMBER_ATTRIBUTEのシグネチャ5のパラメータ

パラメータ 説明

p_collection_name

コレクションの名前。最大長は255バイトです。コレクション名は大/小文字が区別されず、大文字に変換されます。このコレクションが、カレント・ユーザーの指定された名前で、同じセッションに存在しないと、エラーが戻されます。

p_seq

更新するコレクション・メンバーの順序番号。

p_attr_number

更新するNUMBERメンバー属性の属性番号。有効な値は1から5です。この範囲外の番号はすべて無視されます。

p_number_value

更新するNUMBERメンバー属性の属性値。

次の例では、Departmentsというコレクションのコレクション順序番号2の1つ目の数値属性を値3000に設定します。

BEGIN
    APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
        p_collection_name => 'Departments',
        p_seq => 2,
        p_attr_number => 1,
        p_number_value => 3000);
END;