Categorias:

Funções de cadeia de caracteres e binários (General)

LTRIM

Remove os caracteres iniciais, à esquerda, incluindo o espaço em branco, de uma cadeia de caracteres.

Nota

Para remover caracteres em uma cadeia de caracteres, você pode usar a função REPLACE.

Consulte também:

RTRIM , TRIM

Sintaxe

LTRIM( <expr> [, <characters> ] )
Copy

Argumentos

expr

A expressão das cadeias de caracteres a serem excluídas.

characters

Um ou mais caracteres a serem removidos remover do lado esquerdo de expr.

O valor padrão é ' ' (um caractere de espaço em branco único). Se nenhum caractere for especificado, somente os espaços em branco serão removidos.

Retornos

Esta função retorna um valor do tipo de dados NULL ou VARCHAR. Se qualquer argumento for NULL, retorna NULL.

Notas de uso

  • Você pode especificar os caracteres em characters em qualquer ordem.

  • Uma especificação de :codenowrap:` “ “` em characters não remove outros caracteres de espaço em branco (como caracteres de tabulação, caracteres de fim de linha e assim por diante). Especifique explicitamente esses caracteres para removê-los.

  • Quando characters for especificado, você deve especificar explicitamente os caracteres para remover os espaços em branco. Por exemplo, ' $.' remove todos os espaços em branco da frente, sinais de dólar e períodos da cadeia de caracteres de entrada.

Detalhes do agrupamento

O agrupamento é compatível quando o segundo argumento opcional é omitido ou quando ele contém apenas espaços em branco.

A especificação de agrupamento do valor retornado é a mesma que a especificação de agrupamento do primeiro argumento.

Exemplos

Remover os caracteres 0 e # no início de uma cadeia de caracteres:

SELECT LTRIM('#000000123', '0#');
Copy
+---------------------------+
| LTRIM('#000000123', '0#') |
|---------------------------|
| 123                       |
+---------------------------+

Os exemplos restantes usam os seguintes dados da tabela. Além disso, as consultas envolvem as cadeias de caracteres nos caracteres > e < para ajudar você a visualizar o espaço em branco.

CREATE OR REPLACE TABLE test_ltrim_function(column1 VARCHAR);

INSERT INTO test_ltrim_function VALUES ('  #Leading Spaces');
Copy

Remova espaços em branco iniciais de uma cadeia de caracteres. Este exemplo não especifica o segundo argumento characters porque o padrão são espaços em branco.

SELECT CONCAT('>', CONCAT(column1, '<')) AS original_value,
       CONCAT('>', CONCAT(LTRIM(column1), '<')) AS trimmed_value
  FROM test_ltrim_function;
Copy
+---------------------+-------------------+
| ORIGINAL_VALUE      | TRIMMED_VALUE     |
|---------------------+-------------------|
| >  #Leading Spaces< | >#Leading Spaces< |
+---------------------+-------------------+

Remova os espaços em branco iniciais e # de uma cadeia de caracteres. Este exemplo especifica o segundo argumento characters porque remove outros caracteres além dos espaços em branco.

SELECT CONCAT('>', CONCAT(column1, '<')) AS original_value,
       CONCAT('>', CONCAT(LTRIM(column1, ' #'), '<')) AS trimmed_value
  FROM test_ltrim_function;
Copy
+---------------------+------------------+
| ORIGINAL_VALUE      | TRIMMED_VALUE    |
|---------------------+------------------|
| >  #Leading Spaces< | >Leading Spaces< |
+---------------------+------------------+
Linguagem: Português