---

ProcessingInstruction Interface

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.

---

XmlDomGetPIData

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 "?>".

Syntax

oratext* XmlDomGetPIData(
   xmlctx *xctx, 
   xmlpinode *pi)

Parameter	In/Out	Description
xctx	IN	XML context
pi	IN	ProcessingInstruction node

Returns

(oratext *) processing instruction's data [data encoding]

See Also: XmlDomGetPITarget, XmlDomSetPIData

---

XmlDomGetPITarget

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 ProcessingInstructions must have a target, though the data part is optional.

Syntax

oratext* XmlDomGetPITarget(
   xmlctx *xctx,
   xmlpinode *pi)

Parameter	In/Out	Description
xctx	IN	XML context
pi	IN	ProcessingInstruction node

Returns

(oratext *) processing instruction's target [data encoding]

See Also: XmlDomGetPIData, XmlDomSetPIData

---

XmlDomSetPIData

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.

Syntax

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

See Also: XmlDomGetPITarget, XmlDomGetPIData