LTRIM (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL Analytics-Endpunkt in Microsoft FabricWarehouse in Microsoft Fabric

Gibt eine Zeichenfolge zurück, aus der alle führenden Leerzeichen entfernt wurden.

Entfernt das Leerzeichen char(32) oder andere angegebene Zeichen vom Beginn oder Ende einer Zeichenfolge.

Transact-SQL-Syntaxkonventionen

Syntax

Syntax für SQL Server vor SQL Server 2022 (16.x):

LTRIM ( character_expression )

Syntax für SQL Server 2022 (16.x) und höher, Azure SQL Managed Instance, Azure SQL-Datenbank, Azure Synapse Analytics und Microsoft Fabric:

Wichtig

Der Datenbank-Kompatibilitätsgrad muss auf 160 festgelegt sein, damit Sie das optionale characters-Argument verwenden können.

LTRIM ( character_expression , [ characters ] )

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) oder früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

character_expression

Ein Ausdruck aus Zeichen- oder Binärdaten. character_expression kann eine Konstante, Variable oder Spalte sein. character_expression muss einen Datentyp aufweisen (ausschließlich text, ntext und image), der implizit nach varchar konvertiert werden kann. Verwenden Sie in allen anderen Fällen CAST zur expliziten Konvertierung von character_expression.

characters

Ein Literal, eine Variable oder ein Funktionsaufruf eines beliebigen Zeichentyps, der sich nicht auf eine Branchenanwendung bezieht (nvarchar, varchar, nchar oder char), mit Zeichen, die entfernt werden sollten. Die Typen nvarchar(max) und varchar(max) sind nicht zulässig.

Rückgabetypen

Gibt einen Zeichenausdruck mit einem Zeichenargumenttyp zurück, aus dem das Leerzeichen char(32) oder andere angegebene Zeichen vom Beginn eines Ausdrucks character_expression entfernt werden. Gibt NULL zurück, wenn die Eingabezeichenfolge NULL ist.

Hinweise

Um das Positionsargument für optionale Zeichen zu aktivieren, aktivieren Sie die Datenbankkompatibilitätsebene 160 für die Datenbank(en), mit der/denen Sie beim Ausführen von Abfragen eine Verbindung herstellen.

Beispiele

A. Entfernen führender Leerzeichen

Im folgenden Beispiel werden mit LTRIM die führenden Leerzeichen einer Zeichenvariablen entfernt.

SELECT LTRIM('     Five spaces are at the beginning of this string.');

Hier ist das Resultset.

---------------------------------------------------------------  
  Five spaces are at the beginning of this string.

B: Entfernen führender Leerzeichen mithilfe einer Variablen

Im folgenden Beispiel werden mit LTRIM die führenden Leerzeichen einer Zeichenvariablen entfernt.

DECLARE @string_to_trim VARCHAR(60);  
SET @string_to_trim = '     Five spaces are at the beginning of this string.';  
SELECT  
    @string_to_trim AS 'Original string',
    LTRIM(@string_to_trim) AS 'Without spaces';  
GO

Hier ist das Resultset.

Original string                                            Without spaces
-----------------------------------------------------   ---------------------------------------------
     Five spaces are at the beginning of this string.    Five spaces are at the beginning of this string.

C. Entfernen der angegebenen Zeichen vom Anfang einer Zeichenfolge

Wichtig

Der Datenbank-Kompatibilitätsgrad muss auf 160 festgelegt sein, damit Sie das optionale characters-Argument verwenden können.

Im folgenden Beispiel werden die Zeichen 123 vom Anfang der Zeichenfolge 123abc. entfernt.

SELECT LTRIM('123abc.' , '123.');

Hier ist das Resultset.

abc.

Siehe auch