SUBSTRING-Funktion [Zeichenfolge]

Gibt eine Teilzeichenfolge einer Zeichenfolge zurück.

Syntax

{ SUBSTRING | SUBSTR } ( Zeichenfolgenausdruck, Start 
[, Länge ] )

Parameter

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

Rückgabe

LONG BINARY

LONG VARCHAR

LONG NVARCHAR

Bemerkungen

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/2003-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 Länge gibt an, dass die Teilkette Länge Zeichen rechts von der Startposition endet. Eine negative Länge 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 die Länge negativ ist, wird ein Start-Wert von "-1" verwendet.	Eine positive Länge gibt an, dass die Teilkette Länge Zeichen rechts von der Startposition endet. Eine negative Länge gibt maximal Länge 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 Länge gibt an, dass die Teilkette Länge Zeichen rechts von der Startposition endet.

Eine negative Länge 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 die Länge negativ ist, wird ein Start-Wert von "-1" verwendet.

Eine positive Länge gibt an, dass die Teilkette Länge Zeichen rechts von der Startposition endet.

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

Wenn der 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änge-Semantik verwendet wird, wird der Rückgabewert soweit wie möglich mit Ausdrücken der Zeichenlänge-Semantik beschrieben.

Siehe auch

Standards und Kompatibilität

SQL/2003 Kernfunktion.

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.
Senden Sie uns Feedback über diese Seite via E-Mail.