fn:reverse

(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: Funktionen für Sequenzen

Herkunft: XPath 2.0

Rückgabewert: Eine Sequenz; die Kopie der Eingabesequenz mit umgekehrter Reihenfolge der in ihr enthaltenen Items.

Aufruf/Argumente:

fn:reverse($eingabesequenz)

$eingabesequenz:
Eine Sequenz aus einer beliebigen Anzahl von Items beliebigen Typs, die kopiert und für die Ausgabesequenz in ihrer Reihenfolge umgekehrt werden.

Verwendungszweck:

Die Funktion fn:reverse() gibt die Items einer Eingabesequenz in umgekehrter Reihenfolge als neue Ausgabesequenz zuück. Das erste Item der Eingabesequenz wird damit zum letzten Item der Ausgabe­sequenz, das letzte Item der Eingabesequenz wiederum zum ersten Item der Ausgabesequenz. Der Wert und Datentyp jedes einzelnen Items bleiben dabei erhalten.

Besteht die Eingabesequenz nur aus einem Item, wird sie unverändert zurück­gegeben. Wird der Funktion die leere Sequenz übergeben, so gibt sie entspre­chend eine leere Ergebnissequenz zurück.

Beispiel – Umkehrung der Reihenfolge der Items einer Sequenz:

fn:reverse(('a', 'b', 'c'))

ergibt ('c', 'b', 'a'). Das letzte Item der Eingabesequenz wird zum ersten Item der Ausgabesequenz und vice versa.

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

fn:reverse($arg as item()*) as item()*

   

<< zurück

vor >>