LEFT (Transact-SQL)

Gibt den linken Teil einer Zeichenfolge mit der angegebenen Anzahl von Zeichen zurück.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

LEFT ( character_expression , integer_expression )

Argumente

  • character_expression
    Ein Ausdruck aus Zeichen oder Binärdaten. character_expression kann eine Konstante, Variable oder Spalte sein. character_expression kann jeden Datentyp mit Ausnahme von text oder ntext aufweisen, der implizit in varchar oder nvarchar konvertiert werden kann. Verwenden Sie in allen anderen Fällen die CAST-Funktion zur expliziten Konvertierung von character_expression.

  • integer_expression
    Ist eine positive ganze Zahl, die angibt, wie viele Zeichen von character_expression zurückgegeben werden. Wenn integer_expression negativ ist, wird ein Fehler zurückgegeben. Wenn integer_expression vom Typ bigint ist und einen umfangreichen Wert enthält, muss character_expression von einem Datentyp mit umfangreichen Werten sein, z. B. varchar(max).

    Für den integer_expression-Parameter wird ein UTF-16-Ersatzzeichen als ein Zeichen gezählt.

Rückgabetypen

Gibt varchar zurück, wenn character_expression von einem Nicht-Unicode-Zeichendatentyp ist.

Gibt nvarchar zurück, wenn character_expression von einem Unicode-Zeichendatentyp ist.

Hinweise

Bei Verwendung von SC-Sortierungen zählt der integer_expression-Parameter ein UTF-16-Ersatzpaar als ein Zeichen. Weitere Informationen finden Sie unter Sortierung und Unicode-Unterstützung.

Beispiele

A.Verwenden von LEFT mit einer Spalte

Im folgenden Beispiel werden die ersten fünf Zeichen der Produktnamen zurückgegeben.

USE AdventureWorks2012;
GO
SELECT LEFT(Name, 5) 
FROM Production.Product
ORDER BY ProductID;
GO

B.Verwenden von LEFT mit einer Zeichenfolge

Im folgenden Beispiel wird LEFT zur Rückgabe der beiden ersten Zeichen der Zeichenfolge abcdefg verwendet.

SELECT LEFT('abcdefg',2)
GO

Dies ist das Resultset.

-- 
ab 

(1 row(s) affected)

Siehe auch

Verweis

CAST und CONVERT (Transact-SQL)

Datentypen (Transact-SQL)

Zeichenfolgenfunktionen (Transact-SQL)