XSL-T / Die XSLT - Struktur / xsl:assert

xsl:assert

➪ xsl:assert ist in der Lage, den Programmablauf zu kontrollieren.

Siehe

• XSLT 3.0: xsl:assert

<xsl:assert
  test = expression
  select? = expression
  error-code? = { eqname } >
  <!-- Content: sequence-constructor -->
</xsl:assert>

• Attribut: version (Typ: xs:decimal)
• Attribut: _version (Typ: xs:string)
• Attribut: default-collation (Typ: xsl:uri-list)
• Attribut: default-mode (Typ: xsl:default-mode-type)
• Attribut: default-validation (Typ: xsl:validation-strip-or-preserve)
• Attribut: exclude-result-prefixes (Typ: xsl:prefix-list-or-all)
• Attribut: expand-text (Typ: xsl:yes-or-no)
• Attribut: extension-element-prefixes (Typ: xsl:prefix-list)
• Attribut: use-when (Typ: xsl:expression)
• Attribut: xpath-default-namespace (Typ: xs:anyURI)
• Attribut: _default-collation (Typ: xs:string)
• Attribut: _default-mode (Typ: xs:string)
• Attribut: _default-validation (Typ: xs:string)
• Attribut: _exclude-result-prefixes (Typ: xs:string)
• Attribut: _expand-text (Typ: xs:string)
• Attribut: _extension-element-prefixes (Typ: xs:string)
• Attribut: _use-when (Typ: xs:string)
• Attribut: _xpath-default-namespace (Typ: xs:string)
• Attribut: test (Typ: xsl:expression). Pattern: .+
• Attribut: select (Typ: xsl:expression). Pattern: .+
• Attribut: error-code (Typ: xsl:avt)
• Attribut: _test (Typ: xs:string)
• Attribut: _select (Typ: xs:string)
• Attribut: _error-code (Typ: xs:string)
• Assertions: exists(@test | @_test)

Im folgenden Beispiel wird eine Variable v0 mit dem Wert "0" initialisiert. Vor der Weiterverarbeitung mit <xsl:value-of select="1 div $v0"/> (was bei try/catch eine Durch-Null-Division auslösen würde) wird via xsl:assert der weitere Programmablauf davon abhängig gemacht, dass v0 nicht "0" ist; im anderen Fall wird das Programm abgebrochen.

<xsl:stylesheet 
     xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 
     xmlns:xs="http://www.w3.org/2001/XMLSchema" 
     exclude-result-prefixes="xs" version="3.0">
  <xsl:output method="xml" 
       version="1.0" 
       encoding="UTF-8" indent="yes"/>
  <xsl:template match="/">
    <ROOT>
      <xsl:variable name="v0" select="xs:integer('0')"/>
      <xsl:assert test="$v0 != 0">
        <xsl:message>FEHLER: die Variable ist 0</xsl:message>        
      </xsl:assert>
      <xsl:value-of select="1 div $v0"/>
    </ROOT>
  </xsl:template>
</xsl:stylesheet>

Der Aufruf des obigen Stylesheets wird mit dieser Meldung abgebrochen:

FEHLER: die Variable ist 0
Datei C:\wg\test.xslt: XSL-Transformation fehlgeschlagen
Die Transformation wurde durch <xsl:assert> beendet
  Fehlerpfad: xsl:stylesheet / xsl:template / ROOT / xsl:assert
  Details
  XTMM9001: Der Abbruch einer Transformation mit <xsl:assert> 
  hat einen nicht rückgängig zu machenden 
  dynamischen Fehler verursacht.''

wg / 24. September 2020

Fragen? Anmerkungen? Tipps?

Bitte nehmen Sie Kontakt zu mir auf.