Append

Description

The Append method is overloaded:

  • Syntax 1 appends an input string to the text content that already exists within the current PBDOM_COMMENT object.

  • Syntax 2 appends the text data of a PBDOM_CHARACTERDATA object to the text content that already exists within the current PBDOM_COMMENT object.

Syntax

For this syntax

See

Append(string strAppend)

Append Syntax 1

Append(pbdom_characterdata pbdom_characterdata_ref)

Append Syntax 2


Append Syntax 1

Description

Appends an input string to the text content that already exists within the current PBDOM_COMMENT object.

Syntax

pbdom_comment_name.Append(string strAppend)

Argument

Description

pbdom_comment_name

The name of a PBDOM_COMMENT

strAppend

The string you want to append to the existing text of the current PBDOM_COMMENT object


Return value

PBDOM_CHARACTERDATA. The current PBDOM_COMMENT modified and returned as a PBDOM_CHARACTERDATA object.

Append Syntax 2

Description

Appends the text data of a PBDOM_CHARACTERDATA object to the text content that exists within the current PBDOM_COMMENT object.

Syntax

pbdom_comment_name.Append(pbdom_characterdata pbdom_characterdata_ref)

Argument

Description

pbdom_comment_name

The name of a PBDOM_COMMENT

pbdom_characterdata_ref

The referenced PBDOM_CHARACTERDATA object whose text data is to be appended to the existing text of the current PBDOM_COMMENT object


Return value

PBDOM_CHARACTERDATA. The current PBDOM_COMMENT modified and returned as a PBDOM_CHARACTERDATA object.

Throws

EXCEPTION_PBDOM_OBJECT_INVALID_FOR_USE -- If the input PBDOM_CHARACTERDATA is not a reference to a PBDOM_CHARACTERDATA-derived object.

Usage

Note that JDOM does not define an Append method for its COMMENT class. Because PBDOM implements its Append method in the base PBDOM_CHARACTERDATA class, a PBDOM_TEXT object, a PBDOM_CDATA object, and a PBDOM_COMMENT object can append their internal text data to each other because they are all PBDOM_CHARACTERDATA-derived objects.