Partilhar via


LTRIM (Transact-SQL)

Aplica-se a:SQL ServerBase de Dados SQL do AzureInstância Gerida do Azure SQLAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Ponto de Extremidade de Análise SQL no Microsoft FabricArmazém no Microsoft FabricBase de Dados SQL no Microsoft Fabric

Devolve uma cadeia de caracteres após truncar todos os espaços iniciais.

Remove caracteres char(32) de espaço ou outros caracteres especificados do início de uma cadeia.

Transact-SQL convenções de sintaxe

Sintaxe

Sintaxe para SQL Server antes do SQL Server 2022 (16.x):

LTRIM ( character_expression )

Sintaxe para SQL Server 2022 (16.x) e posteriores, Azure SQL Managed Instance, Azure SQL Database, Azure Synapse Analytics e Microsoft Fabric:

Importante

Precisas de ter o nível de compatibilidade da base de dados definido para 160 para usar o argumento de caracteres opcionais.

LTRIM ( character_expression , [ characters ] )

Arguments

character_expression

Uma expressão de caracteres ou dados binários. character_expression pode ser uma constante, variável ou coluna. character_expression deve ser de um tipo de dado, exceto texto, ntexto e imagem, que seja implicitamente convertível para varchar. Caso contrário, use CAST para converter explicitamente character_expression.

Personagens

Uma chamada literal, variável ou função de qualquer tipo de caractere não-LOB (nvarchar, varchar, nchar ou char) contendo caracteres que devem ser removidos. Os tipos nvarchar(max) e varchar(max) não são permitidos.

Tipos de devolução

Devolve uma expressão de carácter com um tipo de argumento de string, onde o carácter char(32) de espaço ou outros caracteres especificados são removidos do início de um character_expression. Retorna NULL se a cadeia de caracteres de entrada for NULL.

Observações

Para ativar o argumento posicional dos caracteres opcionais, ative o nível 160 de compatibilidade da base de dados na base de dados à qual se liga ao executar consultas.

Examples

A. Remover espaços à esquerda

O exemplo seguinte usa LTRIM para remover espaços iniciais de uma expressão de carácter.

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

Aqui está o conjunto de resultados.

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

B: Remover espaços iniciais usando uma variável

O exemplo seguinte é usado LTRIM para remover espaços iniciais de uma variável de carácter.

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

Aqui está o conjunto de resultados.

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

C. Remover caracteres especificados do início de uma cadeia

Importante

Precisas de definir o nível de compatibilidade da base de dados para 160 usar o argumento de caracteres opcionais.

O exemplo seguinte remove os caracteres 123 do início da 123abc. cadeia.

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

Aqui está o conjunto de resultados.

abc.