xml.DomDocument.getElementsByTagNameNS

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

Syntax

getElementsByTagNameNS(
   tag STRING,
   ns STRING )
  RETURNS xml.DomNodeList
  1. tag defines the name of the XML Element tag to match or "*" to match all tags.
  2. ns defines the namespace URI of the XML Element tag to match, or "*" to match all namespaces.

Usage

Use this method to return a xml.DomNodeList object containing all namespace qualified XML Element DomNode objects with the same tag name and namespace in the entire document. The tag string contains the name of the XML Element tag to match, or use "*" to match all tags. ns is the namespace URI of the XML Element tag to match, or use "*" 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).