DOM Get next sibling XML element

version 2004.2 (Modified)

DOM Get next sibling XML element (elementRef{; siblingElemName{; siblingElemValue}}) String

The DOM Get next sibling XML element command returns a reference to the next "sibling" of the XML element passed as reference. This reference can be used with other XML parsing commands.

The siblingElemName and siblingElemValue parameters, if they are passed, receive respectively the name and the value of the "sibling" element.

This command is used to navigate among the "children" of the XML element.

After the last "sibling," the system variable OK is set to 0.

1. Retrieval of the reference of the next sibling XML element following the element passed as parameter:

   C_STRING(16;$xml_Parent_Ref;$next_XML_Ref)
   $next_XML_Ref:=DOM Get next sibling XML element($xml_Parent_Ref)

2. Retrieval in a reference loop of all the child XML elements following the parent element passed as parameter, beginning with the first child:

   C_STRING(16;$xml_Parent_Ref;$first_XML_Ref;$next_XML_Ref)

   $first_XML_Ref:=DOM Get first child XML element($xml_Parent_Ref)
   $next_XML_Ref:=$first_XML_Ref
   While(OK=1)
      $next_XML_Ref:=DOM Get next sibling XML element($next_XML_Ref)
   End while

DOM Get first child XML element.

If the command has been correctly executed and if the parsed element is not the last "sibling" of the referenced element, the system variable OK is set to 1. If an error occurs or if the parsed element is the last "sibling" of the referenced element, it is set to 0.