Obtaining Particular Types of Nodes By Using Node Tests

The node tests allow you to obtain nodes according to their type. Node test is an XPath term. Although a node test looks like a function, it is not a function.

You can use node tests with filters and position specifiers. They resolve to the set of children of the context node that meets the restrictions you specify.

Node tests for XPath 2.0 add to the set of node tests supported for XPath 1.0. Node tests common to both XPath 1.0 and XPath 2.0 are shown in Table 88. Node tests unique to XPath 2.0 are shown in Table 88.

Node Test
Node Type Returned
comment()
               

            
Comment nodes.
node()
               

            
All nonattribute nodes.
processing-
instruction("name") 
               

            
Processing instruction nodes. The processing-instruction() node test selects all processing instructions. When this node test specifies a literal argument, it selects any processing instruction that has a name equal to the value of the argument. If there is no argument, this node test selects all processing instructions.
text()
               

            
Text nodes and CDATA nodes.
Table 88. Node Test Return Values Common to XPath 1.0 and XPath 2.0

Node Test
Node Type Returned
attribute()
               

            
Matches any attribute node.
document-node()
               

            
Matches any document node.
element()
               

            
Matches any element node.
item()
               

            
Matches any single item.
Table 89. Node Test Return Values Unique to XPath 2.0

For each p element in the current context, the following query returns its second text child node:

p/text()[2] 
               

            

Following is a query that finds the third comment child in each foo element anywhere in the document:

//foo/comment()[3]
               

            

About the Document Object

In the Document Object Model (DOM), a document contains comments, processing instructions, and declarations, as well as the document element. As in XPath, the root node is the root of the DOM tree, and the root node is not the same as the document element. This allows comments, declarations, and processing instructions at the document entity level.

For example, the following query finds all comments at the document entity level. In other words, it finds all comments that are immediate children of the root node.

/comment() 
               

            

This query returns the comment at the beginning of the bookstore.xml file:

"This file represents a fragment of a book store inventory database."

Getting Nodes of a Particular Type

A query like the following returns all the comments in a document:

//comment()
               

            

The following query returns the third comment in the document.

(//comment()) [3] 
               

            

EXSLT Tools

EXSLT support in Stylus Studio lets you extend XSLT 1.0 stylesheets and simplify many tasks including computing dates and times, performing mathematical computations, string manipulations and more.

XQuery Integration

Learn how new XQuery technologies can simplify legacy data integration by leveraging industry standards, proven open-source XML processing components, and Stylus Studio's integrated XQuery & XML tools.

XML Generator

Create sample XML instance documents from any XML Schema using the XML Generator. The generated XML document is always valid, well-formed XML!

Introduction to the XQuery Mapper

This free online video demonstration covers Stylus Studio's synchronized XQuery editing and mapping tool which allows you to create any XQuery expression, either manually using Stylus Studio's XQuery editor.

Stylus Most Wanted

 
Free Stylus Studio XML Training:
W3C Member