Бөлісу құралы:


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:

Внимание

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

Замечания

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