15.32 UPDATE_MEMBER_ATTRIBUTE Procedure Signature 1

Updates the specified member attribute in the given named collection.

If a collection does not exist with the specified name for the current user in the same session for the current application ID, an application error occurs.

If the member specified by sequence ID p_seq does not exist, an application error occurs.

If the attribute number specified is invalid or outside the range 1-50, an error occurs.

Any attribute value exceeding 4,000 bytes are truncated to 4,000 bytes.

Syntax

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

Parameters

Note:

Any character attribute exceeding 4,000 characters is truncated to 4,000 characters. Also, the number of members added is based on the number of elements in the first array.

Parameter Description
p_collection_name The name of the collection. Maximum length is 255 bytes. Collection names are case-insensitive and are converted to upper case. An error is returned if this collection does not exist with the specified name of the current user and in the same session.
p_seq Sequence ID of the collection member to be updated.
p_attr_number Attribute number of the member attribute to be updated. Valid values are 1 through 50. Any number outside of this range is ignored.
p_attr_value Attribute value of the member attribute to be updated.

Example

This example updates the second member of the collection Departments, updating the first member attribute to Engineering.

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