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  Sonderzeichen  sybase-tech-blog


Kategorie: ASE: Funktionen: String Funktionen

substring()

Die String Function substring() gibt ein bestimmten Teil eines Strings zurück. Die Länge und Position des Rückgabestrings (Rückgabewertes) wird über die Parameter "start" und "length" geregelt.

Syntax der String Function substring()

    substring ( expression, start, length )
    

Die Parameter der String Function substring()

"expression"
Aus dem angegebenen Wert des Parameters "expression" wird eine Teilsstring, also eine Substring zurückgegeben. Der Parameter muss in entweder in einfachen oder doppelten Anführungsstrichen angegeben werden. Er kann weiterhin aus Spaltennamen, Variablen oder Konstanten bestehen und muss in einem der Datentypen char, varchar, nchar, nvarchar, binary oder varbinary vorliegen. Falls der Wert des Parameters "expression" ein NULL-Wert ist, so wird auch NULL zurückgegeben.

"start"
Der Parameter "start" gibt die Position des ersten Zeichen des auszugebenden Teilstrings an. Ein negativer Wert für den Parameter "start" gibt einen NULL-Wert zurück.

"length"
Der Parameter "length" gibt die Länge des zurückgebenen Teilstrings, also des Substrings an. Ein negativer Wert für den Parameter "length" gibt einen NULL-Wert zurück.

Beispiel für die String Function substring()

    select substring("abcdefg", 2, 3)
go
------
bcd

Gibt den Teilstring "bcd" zurück.

    select substring("abcdefg", -2, 3)
go
------
NULL

Gibt NULL zurück.

    select substring("abcdefg", 2, NULL)
go
------
NULL

Gibt NULL zurück.

    select substring("abcdefg", NULL, 3)
go
------
NULL

Gibt NULL zurück.

    select substring(NULL, 2, 3)
go
------
NULL

Gibt NULL zurück.

    select substring("abcdefg", 2, -3)
go
Msg 536, Level 16, State 1:
Server 'ASE_SERVER_NAME', Line 1:
Invalid length parameter with value of -3 passed to the substring function.
Command has been aborted.
------
(0 rows affected)

Gibt eine Fehlermeldung zurück.

Siehe auch:

ascii(),
char(),
char(n),
charindex(),
char_length(),
compare(),
difference(),
lower(),
ltrim(),
patindex(),
replicate(),
reverse(),
right(),
rtrim(),
sortkey(),
soundex(),
space(),
str(),
String Funktionen,
stuff(),
to_unichar(),
uhighsurr(),
ulowsurr(),
upper(),
uscalar().