RTRIM (Transact-SQL)

  • Статья

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure Управляемый экземпляр SQL Azure Конечная точка аналитики аналитики Synapse Analytics Analytics (PDW)SQL Analyticsв Microsoft FabricХранилище в Microsoft Fabric

Возвращает строку символов, из которой удалены все завершающие пробелы.

Удаляет символ пробела char(32) или другие заданные символы в конце строки.

Соглашения о синтаксисе Transact-SQL

Синтаксис

Синтаксис ДЛЯ SQL Server до SQL Server 2022 (16.x):

RTRIM ( character_expression )

Синтаксис SQL Server 2022 (16.x) и более поздних версий, Управляемый экземпляр SQL Azure, База данных SQL Azure, Azure Synapse Analytics и Microsoft Fabric:

Важно!

Чтобы использовать необязательный аргумент characters, вам потребуется задать для уровня совместимости базы данных значение 160.

RTRIM ( character_expression , [ characters ] )

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

character_expression

Выражение символьных или двоичных данных. character_expression может быть константой, переменной или столбцом. Аргумент character_expression должен иметь тип данных, который может быть неявно преобразован в тип varchar, кроме типов text, ntext и image. В противном случае используйте CAST для явного преобразования character_expression.

characters

Область применения: SQL Server 2022 (16.x) и более поздних версий.

Литерал, переменная или вызов функции любого типа символов, отличного от большого объекта (nvarchar, varchar, nchar или char), которые содержат удаляемые символы. Типы nvarchar(max) и varchar(max) не допускаются.

Типы возвращаемых данных

Возвращает символьное выражение с типом аргумента string, в котором символ пробела char(32) или другие заданные символы удалены из конца выражения character_expression. Возвращает NULL, если входная строка равна NULL.

Замечания

Чтобы включить необязательный позиционный аргумент characters, включите уровень совместимости базы данных 160 в базах данных, к которым вы подключаетесь при выполнении запросов.

Примеры

А. Удалить конечные пробелы

Следующий пример получает строку символов с пробелами в конце предложения и возвращает текст без пробелов в конце предложения.

SELECT RTRIM('Removes trailing spaces.   ');

Результирующий набор:

Removes trailing spaces.

B. Удаление конечных пробелов с использованием переменной

Следующий пример демонстрирует, как использовать RTRIM для удаления конечных пробелов из символьной переменной.

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

Результирующий набор:

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

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

C. Удаление указанных символов из конца строки

Важно!

Чтобы использовать необязательный аргумент characters, вам потребуется задать для уровня совместимости базы данных значение 160.

В следующем примере символы abc. удаляются из конца строки .123abc..

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

Результирующий набор:

.123

См. также