xml.DomDocument.getElementsByTagName

Returns a DomNodeList object containing all XML Element DomNode objects with the same tag name in the entire document.

Syntax

getElementsByTagName(
   tag STRING )
  RETURNS xml.DomNodeList
  1. tag defines the name of the XML Element tag to match or "*" to match all tags.

Usage

Use this method to return a DomNodeList object containing all XML Element DomNode objects with the same tag name in the entire document. The tag string contains the name of the XML Element tag to match, or use "*" to match all tags.

Returns a DomNodeList object, or NULL.

The returned list is ordered using a Depth-First pass algorithm.

In case of error, the method throws an exception and sets the STATUS variable. Depending on the error, a human-readable description of the problem is available in the SQLCA.SQLERRM register. See Error handling in GWS calls (STATUS).