GetData Method (XDATA)

9.8A

The GetData method returns the data string value for a DOM_PROCESSING_INSTRUCTION_NODE node. The method uses the following format:

Where:

label

Optional. A Program Execution Label.

object

Required. An XDATA object.

return

Optional. A Character String Variable that receives the string value for a DOM_PROCESSING_INSTRUCTION_NODE node.

Flags Affected: EOS, OVER, ZERO

Note the following:

1. The ZERO and OVER flags are set FALSE.

2. The EOS flag is set TRUE if the data string value must be truncated to be stored into the {return} variable.

3. If the data string exists, the {return} contains the string data. Otherwise, the {return} variable is set NULL.

4. If this method is executed on a node type other than a DOM_PROCESSING_INSTRUCTION_NODE node, the {return} variable is set a NULL PLB variable. Under normal operations, the PLB program would execute this method after the node type has been determined.

5. The DOM_PROCESSING_INSTRUCTION_NODE 'data' is defined as follows:

 

DOM_PROCESSING_INSTRUCTION_NODE

 

<?target data?>

 

Example:

 

<?xml-stylesheet type="text/css" href="style.css"?>

 

target -> 'xml-stylesheet'

 

data -> 'type="text/css" href="style.css"'

See Also: XDATA, XDATA Methods, Method Syntax