PBDOM_PROCESSINGINSTRUCTION

Description

The PBDOM_PROCESSINGINSTRUCTION class defines behavior for an XML processing instruction. Methods allow you to obtain the target of the processing instruction object as well as its data. You can always access the data as a string, and, where appropriate, as name/value pairs.

Note that the actual processing instruction of a processing instruction object is a string, even if the instruction is divided into separate name="value" pairs. PBDOM does support such a processing instruction object format. If the processing instruction object data does contain pairs, as is commonly the case, then PBDOM_PROCESSINGINSTRUCTION parses them into an internal list of name/value pairs.

Note

Starting from Version 2022, the PBDOM_PROCESSINGINSTRUCTION object is no longer supported to add and modify the XML declarations. An exception will be thrown when the node name of PBDOM_PROCESSINGINSTRUCTION is set to "xml". You can set the XML declaration through the PBDOM_DOCUMENT SetXMLDeclaration method.

Methods

Some of the inherited methods from PBDOM_OBJECT serve no meaningful objective, and only default or trivial functionalities result. These are described in the following table:

Method

Always returns

AddContent

Current PBDOM_PROCESSINGINSTRUCTION. Use AddValue instead.

GetContent

false. Use GetName and GetValue instead.

HasChildren

false.

InsertContent

Current PBDOM_PROCESSINGINSTRUCTION.

IsAncestorObjectOf

false.

RemoveContent

false. Use RemoveValue instead.

SetContent

Current PBDOM_PROCESSINGINSTRUCTION. Use SetData instead.


PBDOM_PROCESSINGINSTRUCTION has the following methods: