GetLabel Method (XDATA)

9.8A

The GetLabel method returns the label string value for the DOM_ELEMENT_NODE and DOM_ATTRIBUTE_NODE node types. The method uses the following format:

Where:

label

Optional. A Program Execution Label.

object

Required. An XDATA object.

return

Optional. A Character String Variable or literal that receives the label string value for the DOM_ELEMENT_NODE and DOM_ATTRIBUTE_NODE node types.

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 label string value must be truncated to be stored into the {return} variable.

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

See Also: XDATA, XDATA Methods, Method Syntax