substring-Funktion

Gibt die Teilzeichenfolge des ersten Arguments zurück, wobei an der Position begonnen wird, die im zweiten Argument angegeben ist. Die Länge wird im dritten Argument angegeben.

string substring(string, number, number?)

Hinweise

Jedes Zeichen in der Zeichenfolge hat eine numerische Position: Das erste Zeichen hat die Position 1, das zweite Zeichen hat die Position 2 usw.

Wenn das dritte Argument nicht angegeben ist, wird die Teilzeichenfolge zurückgegeben, wobei an der angegebenen Position im zweiten Argument begonnen wird und bis zum Ende der Zeichenfolge fortgefahren wird.

Wenn ein Argument nicht vom Typ string ist, wird es zunächst mithilfe der string()-Funktion in eine Zeichenfolge konvertiert. Anschließend wird das Ergebnis dieser Konvertierung ausgewertet.

Vorsicht:
Zeichenfolgenkonvertierungen für Knotengruppen, die als Argumente an diese Funktion übergeben werden, führen möglicherweise zu unerwarteten Ergebnissen.Weitere Informationen finden Sie unter string-Funktion.

Bei dieser Funktion muss die Groß- und Kleinschreibung berücksichtigt werden.

Beispiel

Der folgende Funktionsaufruf gibt "234" zurück:

substring("12345",2,3)

Der folgende Funktionsaufruf gibt "2345" zurück:

substring("12345",2)

Die zurückgegebene Teilzeichenfolge enthält solche Zeichen, bei denen die Position des Zeichens größer als der gerundete Wert des zweiten Arguments ist oder diesem entspricht. Wenn das dritte Argument angegeben wird, muss es kleiner sein als die Summe des gerundeten Werts des zweiten Arguments und des gerundeten Werts des dritten Arguments. Die hierzu verwendeten Vergleiche und Hinzufügungen folgen den Regeln der Norm IEEE 754. Das Runden erfolgt wie beim Aufrufen der round()-Funktion.

In den folgenden Beispielen werden ungewöhnliche Fälle dargestellt.

substring("12345", 1.5, 2.6) gibt "234" zurück

substring("12345", 0, 3) gibt "12" zurück

substring("12345", 0 div 0, 3) hat den Rückgabewert ""

substring("12345", 1, 0 div 0) hat den Rückgabewert ""

substring("12345", -42, 1 div 0) gibt zurück "12345"

substring("12345", -1 div 0, 1 div 0) hat den Rückgabewert ""

In diesem Beispiel werden die vorhergehenden substring()-Ausdrücke veranschaulicht.

XML-Datei

Keine; die XSLT-Datei ruft sich selbst auf.

XSLT-Datei (substring.xsl)

Formatierte Ausgabe

substring("12345",2,3) = 234 substring("12345",2) = 2345 substring("12345", 1.5, 2.6) = 234 substring("12345", 0, 3) = 12 substring("12345", 0 div 0, 3) = substring("12345", 1, 0 div 0) = substring("12345", -42, 1 div 0) = 12345 substring("12345", -1 div 0, 1 div 0) =

Prozessorausgabe

<?xml version="1.0" ?> substring("12345",2,3) = 234<br /> substring("12345",2) = 2345<br /> substring("12345", 1.5, 2.6) = 234<br /> substring("12345", 0, 3) = 12<br /> substring("12345", 0 div 0, 3) = <br /> substring("12345", 1, 0 div 0) = <br /> substring("12345", -42, 1 div 0) = 12345<br /> substring("12345", -1 div 0, 1 div 0) =

Siehe auch

Verweis

Referenz zu XML-Datentypen