current-grouping-key

(Auszug aus "XSLT 2.0 & XPath 2.0" von Frank Bongers, Kapitel 5.)

A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z

   

Kategorie: Kontextinformationen innerhalb einer Sequenz

Herkunft: XSLT 2.0

Rückgabewert: Ein atomarer Wert; der aktuelle Wert des Gruppierkriteriums bei der Verarbeitung einer durch xsl:for-each-group gebildeten Gruppe

Aufruf/Argumente:

current-grouping-key()

Keine Argumente

Verwendungszweck:

Mit Hilfe der Funktion current-grouping-key() kann während der Verarbeitung einer durch die XSLT-Instruktion xsl:for-each-group gebildeten Gruppe auf den ihr zugrunde liegenden aktuellen Wert des Gruppierkriteriums zugeriffen werden. Dieser wird durch die Attribute group-by oder group-adjacent der Instruktion bestimmt. Bei dem zurückgegebenen Wert handelt es sich stets um einen atomaren Wert (eine Singleton-Sequenz) und nie um eine Sequenz aus mehreren Werten.

Die Funktion gibt außerhalb des Kontextes der Auswertung einer xsl:for-each-group-Instruktion stets die leere Sequenz zurück.

Kein current-grouping-key() in XPath-Pattern:
Die Funktion current-grouping-key() ist als Teil von XPath-Pattern verboten. Ihr Einsatz führt dort zu einem statischen Fehler (static error), der die Verarbeitung des Stylesheets unmöglich macht.

Beispiel:

Ein Beispiel befindet sich bei der Erläuterung der XSLT-Instruktion xsl:for-each-group.

Funktionsdefinition:

XSLT 1.0:

Funktion nicht verfügbar

XSLT 2.0:

current-grouping-key() as xs:anyAtomicType

   

<< zurück

vor >>