Поделиться через


LTRIM (Transact-SQL)

Область применения: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure конечной точке аналитики платформы Аналитики Azure Synapse Analytics (PDW) в 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:

Внимание

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

LTRIM ( character_expression , [ characters ] )

Аргументы

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.

Замечания

Чтобы включить необязательный аргумент позиционного аргумента символов , включите уровень 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. Удаление указанных символов из начала строки

Внимание

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

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

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

Вот результирующий набор.

abc.