CREATE-NODE( ) method

Create an XML node in the current document. The first parameter must be a valid X-noderef handle and will refer to the new XML node if the method succeeds. This method merely creates the XML node as part of the XML document. The INSERT-BEFORE or APPEND-CHILD methods are required to actually insert it into the document’s tree.

Syntax
CREATE-NODE( `x-node-handle` , `name` , `type` )

A valid X-noderef handle to use for the new XML node.

A character expression representing the NAME of the node. The relationship between the node NAME and SUBTYPE attributes is shown in Table 75.

A character expression representing the node’s SUBTYPE, which will be one of: ATTRIBUTE, CDATA-SECTION, COMMENT, DOCUMENT-FRAGMENT, ELEMENT, ENTITY-REFERENCE, PROCESSING-INSTRUCTION, TEXT.

Table 75: Relationship between the SUBTYPE and NAME attributes
If the SUBTYPE is . . .	then the NAME attribute is . . .
ATTRIBUTE	The name of the attribute
CDATA-SECTION COMMENT DOCUMENT-FRAGMENT TEXT	A constant value; the `name` parameter is ignored
ELEMENT	The name of the XML tag, with any namespace prefix included
ENTITY-REFERENCE	The name of the entity referenced without leading ampersand and trailing semicolon
PROCESSING-INSTRUCTION	The target; the first token following the <? markup

The following example demonstrates creating a node in a document. If hDoc is an X-document handle, and hNoderef and hNoderefChild are X-noderefs, this is how you would add hNoderefChild to hNoderef in the document associated with hDoc:

/* Assume hNoderef has previously been added to the tree. Create an ABL handle that can refer to a node in an XML parse tree./ CREATE X-NODEREF hNoderefChild. / Create an XML node whose name is "Address" & whose type is "ELEMENT" / hDoc:CREATE-NODE(hNoderefChild, "Address", "ELEMENT") / Put this child into the tree and ultimately into the document. */ hNoderef:APPEND-CHILD(hNoderefChild).

/* Assume hNoderef has previously been added to the tree. Create an ABL handle 
   that can refer to a node in an XML parse tree.*/ 
CREATE X-NODEREF hNoderefChild. 
/* Create an XML node whose name is "Address" & whose type is "ELEMENT" */ 
hDoc:CREATE-NODE(hNoderefChild, "Address", "ELEMENT") 
/* Put this child into the tree and ultimately into the document. */ 
hNoderef:APPEND-CHILD(hNoderefChild).