LTRIM (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)Ponto de extremidade de SQL no Microsoft FabricWarehouse no Microsoft Fabric

Retorna uma cadeia de caracteres depois de truncar todos os espaços à esquerda.

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

Convenções de sintaxe de Transact-SQL

Sintaxe

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

LTRIM ( character_expression )

Sintaxe para o SQL Server 2022 (16.x) e versões posteriores, a Instância Gerenciada de SQL do Azure, o Banco de Dados SQL do Azure, o Azure Synapse Analytics e o Microsoft Fabric:

Importante

Você precisará do nível de compatibilidade do banco de dados definido como 160 para usar o argumento de caracteres opcionais.

LTRIM ( character_expression , [ characters ] )

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

character_expression

Uma expressão de dados binários ou de caracteres. character_expression pode ser uma constante, variável ou coluna. character_expression deve ser um tipo de dados, exceto text, ntext e image, que é implicitamente conversível em varchar. Caso contrário, use CAST para converter character_expression explicitamente.

caracteres

Uma chamada de função, variável ou literal 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 retorno

Retorna uma expressão de caractere com um tipo de argumento de cadeia nas quais o caractere de espaço char(32), ou outros caracteres, são removidos do início da character_expression. Retorna NULL se a cadeia de caracteres de entrada é NULL.

Comentários

Para habilitar o argumento posicional de caracteres opcionais, habilite o nível de compatibilidade do banco de dados 160 nos bancos de dados aos quais você está se conectando ao executar consultas.

Exemplos

a. Remover espaços à esquerda

O exemplo a seguir usa LTRIM para remover espaços à esquerda de uma expressão de caractere.

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

Este é o conjunto de resultados.

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

B: Remover espaços à esquerda usando uma variável

O exemplo a seguir usa LTRIM para remover espaços à esquerda de uma variável de caractere.

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

Este é 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. Remova caracteres especificados do início da cadeia de caracteres

Importante

Você precisará do nível de compatibilidade do banco de dados definido como 160 para usar o argumento de caracteres opcionais.

O exemplo a seguir remove os caracteres 123 do início da cadeia de caracteres 123abc..

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

Este é o conjunto de resultados.

abc.

Confira também