xml.DomDocument.getElementsByTagNameNS

Syntax

getElementsByTagNameNS(
   name STRING,
   ns STRING )
  RETURNING list xml.DomNodeList

1. name is the name of the XML Element tag to match or "*" to match all tags.
2. ns is the namespace URI of the XML Element tag to match, or "*" to match all namespaces.

Usage

Returns a xml.DomNodeList object containing all namespace qualified XML Element DomNode objects with the same tag name and namespace in the entire document; name is the name of the XML Element tag to match, or "*" to match all tags; ns is the namespace URI of the XML Element tag to match, or "*" to match all namespaces. 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).