xml.DomDocument.selectByXPath

Returns a DomNodeList object containing all DomNode objects matching a XPath 1.0 expression.

Syntax

selectByXPath(
   expr STRING,
   args ... )
  RETURNS xml.DomNodeList
  1. expr defines the XPath1.0 expression
  2. args defines a list of prefixes bound to namespaces in order to resolve qualified names in the XPath expression.

Usage

Returns a xml.DomNodeList object containing all DomNode objects matching a XPath 1.0 expression.expr is the XPath1.0 expression, args is a list of prefixes bound to namespaces in order to resolve qualified names in the XPath expression. This list must be filled with an even number of arguments, representing the prefix and its corresponding namespace.

Important: This method is not part of W3C standard API.

Valid example:

selectByXPath(
  "//d:Record", 
  "d", 
  "http://defaultnamespace")
selectByXPath(
  "//ns1:Record", 
  NULL)
selectByXPath(
  "//ns1:Records/ns2:Record", 
  "ns1",
  "http://namespace1", 
  "ns2", 
  "http://namespace2")

Invalid example:

selectByXPath(
  "//ns1:Record", 
  "ns1")

This example is invalid because the namespace definition is missing.

If the namespaces list is NULL, the prefixes and namespaces defined in the document itself are used if available.

A namespace must be an absolute URI (for example, 'http://', 'file://').

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).