Die Funktion fn:substringBefore extrahiert die Teilmenge einer Zeichenkette, die vor einer spezifischen Teil-Zeichenfolge erscheint. Es wird ein Wert vom Typ Zeichenkette zurückgegeben.

Struktur​

fn:substringBefore(Zeichenkette, Zeichenkette)

Parameter​

Parameter

Beschreibung

Zeichenkette

Der Parameter spezifiziert die gesuchte Zeichenkette.

Zeichenkette

Der Parameter spezifiziert den Wert (Teil-Zeichenkette), der verwendet wird, um die gesuchte Zeichenkette zu finden.

Beispiel

Die Werte, die in einem Verteilerattribut gespeichert sind, stellen die Preise für Unterkünfte in verschiedenen Städten dar. Die Preise werden als Bruchzahlen mit 2 Dezimalstellen gespeichert. Wird der Preis eines Londoner Hotels in eine Nachricht eingefügt, werden die Dezimalwerte durch einen Bindestrich ersetzt und der Preis mit einem Pfund-Zeichen angeführt (d.h. 255.85 wird umgewandelt in £255.-). Die Funktion fn:substringBefore extrahiert den Wert vor dem Dezimalpunkt aus dem Attribut ​Preise_London​ wie folgt:

${fn:substringBefore(group.CustomAttribute['Preise_London'], '.')}

Ist der derzeit im angepassten Attribut gespeicherte Wert 255.85, so ist die von der Funktion zurückgegebene Zeichenkette 255. Das Währungszeichen, der Dezimalpunkt und der Bindestrich (hier £255.-) müssen dem Ergebnis mithilfe der Funktion ecm:concat hinzugefügt werden (siehe ⇘ ​ecm:concat​).