fn:one-or-more

(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 Eingabesequenz, sofern diese aus mindestens einem Item besteht.

Aufruf/Argumente:

fn:one-or-more($sequenz)

$sequenz:
Eine Eingabesequenz aus prinzipiell beliebig vielen Items, die von der Funktion jedoch zurückgewiesen wird, wenn sie nicht mindestens aus einem Item besteht. Im Fall der leeren Sequenz wird ein Fehler gemeldet. Dies entspricht der Prüfung der Eingabesequenz auf Kardinalität »+«, also »ein oder mehr« Items.

Verwendungszweck:

Die Funktion erzwingt die Ausgabe einer Sequenz aus mindestens einem Item durch Zurückweisung der leeren Sequenz. In diesem Fall wird mit der Fehlermeldung »fn:one-or-more called with a sequence containing no items« abgebrochen (err:FORG0004). Sequenzen aus einem oder mehr Items werden von der Funktion hingegen unverändert (transparent) weitergegeben.

Die Funktion sollte überall dort eingesetzt werden, wo die leere Sequenz als Eingabewert verhindert werden muss und der Abbruch der Verarbeitung erforderlich ist, wenn dieser Bedin­gung nicht Rechnung getragen wird.

Beispiele:

Beispiel 1 – Aufruf mit mehr als einem Item in der Eingabesequenz:

fn:one-or-more((1, 2, 3))

gibt die übergebene Sequenz (1, 2, 3) zurück.

Beispiel 2 – Aufruf mit genau einem Item in der Eingabesequenz:

fn: one-or-more ((1))

gibt die übergebene Sequenz (1) zurück.

Beispiel 3 – Aufruf mit der leeren Sequenz:

fn: one-or-more (())

bricht mit Fehlermeldung gemäß err:FORG0004 ab.

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

fn:one-or-more($arg as item()*) as item()+

   

<< zurück

vor >>