STUFF (Transact-SQL)

Die STUFF-Funktion fügt eine Zeichenfolge in eine andere Zeichenfolge ein. Sie löscht ab einer bestimmten Anfangsposition eine festgelegte Anzahl von Zeichen in der ersten Zeichenfolge und fügt dort die zweite Zeichenfolge ein.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

STUFF ( character_expression , start , length ,character_expression )

Argumente

  • character_expression
    Ein Ausdruck für Zeichendaten. character_expression kann eine Konstante, Variable oder Spalte mit Zeichen- oder Binärdaten darstellen.

  • start
    Ein ganzzahliger Wert, der die Position angibt, ab der Zeichen gelöscht werden sollen und an der anschließend eine andere Zeichenfolge eingefügt werden soll. Falls start oder length negativ ist, wird eine NULL-Zeichenfolge zurückgegeben. Wenn start länger als der erste (character_expression) ist, wird eine NULL-Zeichenfolge zurückgegeben. start kann vom Datentyp bigint sein.

  • length
    Eine ganze Zahl, die festlegt, wie viele Zeichen gelöscht werden sollen. Falls length länger als der erste Zeichenausdruck (character_expression) ist, erstreckt sich die Löschung bis auf das letzte Zeichen im letzten Zeichenausdruck (character_expression). length kann vom Datentyp bigint sein.

Rückgabetypen

Gibt Zeichendaten zurück, wenn character_expression einer der unterstützten Zeichendatentypen ist. Gibt Binärdaten zurück, wenn character_expression einer der unterstützten Binärdatentypen ist.

Hinweise

Falls die Startposition oder die Länge negativ oder die Startposition größer als die Länge der ersten Zeichenfolge ist, wird eine Nullzeichenfolge zurückgegeben. Wenn es sich um mehr zu löschende Zeichen handelt als die erste Zeichenfolge aufweist, wird die erste Zeichenfolge bis auf das erste Zeichen gelöscht.

Wenn der Ergebniswert größer als der vom Rückgabetyp unterstützte Höchstwert ist, wird ein Fehler ausgegeben.

Beispiele

In diesem Beispiel wird eine neue Zeichenfolge zurückgegeben, indem zunächst drei Zeichen aus der ersten Zeichenfolge (abcdef) ab der Position 2, (also bei b) gelöscht werden. Anschließend wird die zweite Zeichenfolge an der Löschposition eingefügt.

SELECT STUFF('abcdef', 2, 3, 'ijklmn');
GO

Dies ist das Resultset.

--------- 
aijklmnef 

(1 row(s) affected)