SUBSTRING-Funktion [Zeichenfolge]

Gibt eine Teilzeichenfolge einer Zeichenfolge zurück.

Syntax

{ SUBSTRING | SUBSTR } ( string-expression, start 
[, length ] )

Parameter

Zeichenfolgenausdruck Die Zeichenfolge, aus der eine Teilzeichenfolge zurückgegeben werden soll.
start Die Anfangsposition der zurückzugebenden Teilzeichenfolge, in Zeichen.
length Die Länge der zurückzugebenden Teilzeichenfolge, in Zeichen. Wenn length angegeben ist, ist die Teilzeichenfolge auf diese Länge begrenzt.

Das Verhalten der Funktion hängt von der Einstellung der ansi_substring-Datenbankoption ab. Wenn die ansi_substring-Option auf ON gesetzt ist (Standardwert), entspricht das Verhalten der SUBSTRING-Funktion dem ANSI/ISO SQL/2008-Verhalten. Das Verhalten ist wie folgt:

ansi_substring-Optionseinstellung	Startwert	Längenwert
On	Das erste Zeichen in der Zeichenfolge ist auf Position 1. Ein negatives oder ein Null-Start-Offset wird so behandelt, als ob die Zeichenfolge links mit Nicht-Zeichen angefüllt ist.	Eine positive length gibt an, dass die Teilzeichenfolge length Zeichen rechts von der Startposition endet. Eine negative length gibt einen Fehler zurück.
Off	Das erste Zeichen in der Zeichenfolge hat die Position 1. Eine negative Startposition legt eine Anzahl von Zeichen vom Ende anstatt vom Anfang der Zeichenfolge aus fest. Wenn start Null und die Länge nicht-negativ ist, wird ein Start-Wert von "1" verwendet. Wenn Start Null und length negativ ist, wird ein Start-Wert von "-1" verwendet.	Eine positive length gibt an, dass die Teilzeichenfolge length Zeichen rechts von der Startposition endet. Eine negative length gibt maximal length Zeichen links von der Startposition bis zur und einschließlich der Startposition zurück.

ansi_substring-Optionseinstellung

Startwert

Längenwert

Das erste Zeichen in der Zeichenfolge ist auf Position 1. Ein negatives oder ein Null-Start-Offset wird so behandelt, als ob die Zeichenfolge links mit Nicht-Zeichen angefüllt ist.

Eine positive length gibt an, dass die Teilzeichenfolge length Zeichen rechts von der Startposition endet.

Eine negative length gibt einen Fehler zurück.

Off

Das erste Zeichen in der Zeichenfolge hat die Position 1. Eine negative Startposition legt eine Anzahl von Zeichen vom Ende anstatt vom Anfang der Zeichenfolge aus fest.

Wenn start Null und die Länge nicht-negativ ist, wird ein Start-Wert von "1" verwendet. Wenn Start Null und length negativ ist, wird ein Start-Wert von "-1" verwendet.

Eine positive length gibt an, dass die Teilzeichenfolge length Zeichen rechts von der Startposition endet.

Eine negative length gibt maximal length Zeichen links von der Startposition bis zur und einschließlich der Startposition zurück.

Wenn Zeichenfolgenausdruck ein binärer Datentyp ist, verhält sich die SUBSTRING-Funktion wie BYTE_SUBSTR.

Um Zeichen am Ende einer Zeichenfolge zu erhalten, benutzen Sie die Funktion RIGHT.

Diese Funktion unterstützt NCHAR-Eingaben bzw. Ausgaben. Wenn in der Eingabezeichenfolge Zeichenlängensemantik verwendet wurde, wird der Rückgabewert soweit wie möglich mit Ausdrücken der Zeichenlängensemantik beschrieben.

Siehe auch

Standards und Kompatibilität

SQL/2008 SUBSTRING ist eine Kernfunktion des SQL/2008-Standards. Die Implementierung im Standard unterscheidet sich etwas von der SQL Anywhere-Implementierung: Im Standard ist SUBSTRING mit drei Parametern unter Verwendung der Schlüsselwörter FROM und FOR definiert, die beide in SQL Anywhere nicht erforderlich sind.

Beispiel

Die folgende Tabelle zeigt die Werte, die von der SUBSTRING-Funktion zurückgegeben werden.

Beispiel	Ergebnis
SUBSTRING( 'front yard', 1, 4 )	fron
SUBSTRING( 'back yard', 6, 4 )	yard
SUBSTR( 'abcdefgh', 0, -2 )	Gibt einen Fehler zurück, wenn ansi_substring "On" ist
SUBSTR( 'abcdefgh', -2, 2 )	Gibt eine leere Zeichenfolge zurück, wenn ansi_substring "On" ist

Kommentieren Sie diese Seite in DocCommentXchange.