LTRIM (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System) Ponto de extremidade de análise do SQL Warehouse 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ê precisa do nível de compatibilidade do banco de dados definido como 160 para usar o argumento de caracteres opcionais.

LTRIM ( character_expression , [ characters ] )

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 160 de compatibilidade do banco de dados no banco de dados ao qual você se conecta 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.');

Veja a seguir 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

Veja a seguir 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ê precisa 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.');

Veja a seguir o conjunto de resultados.

abc.

Conteúdo relacionado