XSLT, 2nd Edition

Name

[2.0] index-of()

Given a sequence and a search argument, returns a sequence of integers indicating the position(s) of the search argument in the sequence.

Syntax

xs:integer* index-of($sequenceParam as xs:anyAtomicType*, 
                     $searchParam as xs:anyAtomicType)
xs:integer* index-of($sequenceParam as xs:anyAtomicType*, 
                     $searchParam as xs:anyAtomicType, 
                     $collation as xs:string)

Inputs

A sequence of atomic values and a search argument (also an atomic value). The optional third argument specifies the URL of a collation to be used when comparing the search argument to the values in the sequence.

Outputs

A sequence of xs:integers representing the position(s) of the search argument in the sequence.

If the search sequence is the empty sequence or if no values in the sequence match the search argument, index-of() returns the empty sequence. Also, when comparing the search argument to values in the sequence, the processor uses the rules defined for the eq operator for each datatype. If the eq operator is not defined for a given datatype, all values of that datatype will not be considered equal to the search argument.

Defined in

XQuery 1.0 and XPath 2.0 Functions and Operators section 15.1, “General Functions and Operators on Sequences.”

Example

Here is a short stylesheet that uses the index-of() function:

<?xml version="1.0"?>
<!-- index-of.xsl --> <xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xsl:output method="text"/> <xsl:template ...