ends-with()

Description

ends-with() tests whether the string in the first argument ends with the string in the second argument. It returns true if the suffix matches, false otherwise.

The comparison uses codepoint-by-codepoint equality by default (same as XPath’s = operator on strings). In XPath 2.0 a third collation argument is allowed for locale-sensitive suffix testing, though most processors default to the Unicode codepoint collation.

If either argument is an empty string "", special rules apply: any string ends with "" (always true), and "" ends with "" (also true).

Parameters

Return value

xs:boolean — true if string ends with suffix, false otherwise.

Examples

Filtering files by extension

Input XML:

<?xml version="1.0" encoding="UTF-8"?>
<files>
  <file>report.pdf</file>
  <file>data.xml</file>
  <file>summary.pdf</file>
  <file>stylesheet.xsl</file>
  <file>notes.txt</file>
</files>

Stylesheet:

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:output method="xml" indent="yes"/>

  <xsl:template match="/files">
    <pdf-files>
      <xsl:for-each select="file[ends-with(., '.pdf')]">
        <file><xsl:value-of select="."/></file>
      </xsl:for-each>
    </pdf-files>
  </xsl:template>
</xsl:stylesheet>

Output:

<pdf-files>
  <file>report.pdf</file>
  <file>summary.pdf</file>
</pdf-files>

Checking namespace URIs

Stylesheet:

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:output method="xml" indent="yes"/>

  <xsl:template match="/namespaces">
    <xhtml-ns>
      <!-- Select namespace nodes whose URI ends with 'xhtml' -->
      <xsl:for-each select="ns[ends-with(@uri, 'xhtml')]">
        <match prefix="{@prefix}" uri="{@uri}"/>
      </xsl:for-each>
    </xhtml-ns>
  </xsl:template>
</xsl:stylesheet>

Notes

• ends-with() was introduced in XPath 2.0. In XPath 1.0 there is no built-in equivalent; the workaround is substring($s, string-length($s) - string-length($suffix) + 1) = $suffix.
• The comparison is case-sensitive by default. For case-insensitive suffix testing, normalize both strings with lower-case() first.
• An empty suffix always returns true. An empty string with a non-empty suffix returns false.
• starts-with() (available in both XPath 1.0 and 2.0) is the complementary function for prefix testing.

See also

• starts-with()
• contains()
• substring()
• lower-case()