RTRIM (Transact-SQL)

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 nachfolgenden Leerzeichen entfernt wurden.

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

Transact-SQL-Syntaxkonventionen

Syntax

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

RTRIM ( 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.

RTRIM ( character_expression , [ characters ] )

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und 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

Gilt für: SQL Server 2022 (16.x) und höher.

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 Typ von Zeichenfolgenargument zurück, aus dem das Leerzeichenchar(32) oder andere angegebene Zeichen vom Ende 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. Nachfolgende Leerzeichen löschen.

Im folgenden Beispiel wird eine Zeichenfolge mit Leerzeichen am Ende des Satzes genommen und der Text ohne die Leerzeichen am Ende des Satzes zurückgegeben.

SELECT RTRIM('Removes trailing spaces.   ');

Hier ist das Resultset.

Removes trailing spaces.

B. Entfernen von nachgestellten Leerzeichen mit einer Variable

Im folgenden Beispiel wird verdeutlicht, wie nachfolgende Leerzeichen mit RTRIM aus einer Zeichenvariablen entfernt werden können.

DECLARE @string_to_trim VARCHAR(60);  
SET @string_to_trim = 'Four spaces are after the period in this sentence.    ';  
SELECT @string_to_trim + ' Next string.';  
SELECT RTRIM(@string_to_trim) + ' Next string.';  
GO

Hier ist das Resultset.

Four spaces are after the period in this sentence.     Next string.

Four spaces are after the period in this sentence. Next string.

C. Entfernen der angegebenen Zeichen vom Ende 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 abc. vom Ende der Zeichenfolge .123abc. entfernt.

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

Hier ist das Resultset.

.123

Siehe auch