LTRIM (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):

LTRIM ( character_expression )

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

Важно!

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

LTRIM ( character_expression , [ characters ] )

Примечание.

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

Аргументы

character_expression

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

characters

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

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

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

Замечания

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

Примеры

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

В приведенном ниже примере функция LTRIM используется для удаления начальных пробелов из символьного выражения.

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

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

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

Б. Удаление начальных пробелов с помощью переменной

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

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

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

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

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

Важно!

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

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

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

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

abc.

См. также