Table 4-11 summarizes the methods of available through the ProcessingInstruction
interface.
Table 4-11 Summary of ProcessingInstruction Methods; DOM Package
Function | Summary |
---|---|
XmlDomGetPIData
|
Get processing instruction's data. |
XmlDomGetPITarget
|
Get PI's target. |
XmlDomSetPIData
|
Set processing instruction's data. |
Returns the content (data) of a processing instruction (in the data encoding). If the node is not a ProcessingInstruction
, returns NULL
. The content is the part from the first non-whitespace character after the target until the ending "?>
".
oratext* XmlDomGetPIData( xmlctx *xctx, xmlpinode *pi)
Parameter | In/Out | Description |
---|---|---|
xctx |
IN |
XML context |
pi |
IN |
ProcessingInstruction node
|
(oratext *)
processing instruction's data [data encoding]
Returns a processing instruction's target string. If the node is not a ProcessingInstruction
, returns NULL
. The target is the first token following the markup that begins the ProcessingInstruction
. All ProcessingInstruction
s must have a target, though the data part is optional.
oratext* XmlDomGetPITarget( xmlctx *xctx, xmlpinode *pi)
Parameter | In/Out | Description |
---|---|---|
xctx |
IN |
XML context |
pi |
IN |
ProcessingInstruction node
|
(oratext *)
processing instruction's target [data encoding]
Sets a ProcessingInstruction
's content, which must be in the data encoding. It is not permitted to set the data to NULL
. If the node is not a ProcessingInstruction
, does nothing. The new data is not verified, converted, or checked.
void XmlDomSetPIData( xmlctx *xctx, xmlpinode *pi, oratext *data)
Parameter | In/Out | Description |
---|---|---|
xctx |
IN |
XML context |
pi |
IN |
ProcessingInstruction node
|
data |
IN |
ProcessingInstruction 's new data; data encoding
|