TRIM¶

Sintaxe¶

TRIM( <expr> [, <characters> ] )

Argumentos¶

expr

Uma expressão de cadeia de caracteres a ser excluída.

characters

Um ou mais caracteres a serem removidos do lado esquerdo e direito do 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.

• Para remover espaços em branco, os caracteres devem ser explicitamente incluídos no argumento. Por exemplo, ' $.' remove todos os espaços em branco iniciais e finais, 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 * e - no início e no final de uma cadeia de caracteres:

SELECT '*-*ABC-*-' AS original,
       TRIM('*-*ABC-*-', '*-') AS trimmed;

+-----------+---------+
| ORIGINAL  | TRIMMED |
|-----------+---------|
| *-*ABC-*- | ABC     |
+-----------+---------+

Remove uma nova linha no final de uma cadeia de caracteres. Este exemplo usa a função CONCAT para envolver as cadeias de caracteres entre caracteres > e < para ajudar você a visualizar os espaços em branco.

SELECT CONCAT('>', CONCAT('ABC\n', '<')) AS original,
       CONCAT('>', CONCAT(TRIM('ABC\n', '\n'), '<')) AS trimmed;

+----------+---------+
| ORIGINAL | TRIMMED |
|----------+---------|
| >ABC     | >ABC<   |
| <        |         |
+----------+---------+

Remova os espaços em branco no início e no final de uma cadeia de caracteres. Este exemplo delimita as cadeias de caracteres com caracteres > e < para ajudar a visualizar o espaço em branco. Também mostra que a função retorna NULL para a entrada NULL.

CREATE OR REPLACE TABLE test_trim_function(column1 VARCHAR);

INSERT INTO test_trim_function VALUES ('  Leading Spaces'), ('Trailing Spaces  '), (NULL);

SELECT CONCAT('>', CONCAT(column1, '<')) AS original_values,
       CONCAT('>', CONCAT(TRIM(column1), '<')) AS trimmed_values
  FROM test_trim_function;

+---------------------+-------------------+
| ORIGINAL_VALUES     | TRIMMED_VALUES    |
|---------------------+-------------------|
| >  Leading Spaces<  | >Leading Spaces<  |
| >Trailing Spaces  < | >Trailing Spaces< |
| NULL                | NULL              |
+---------------------+-------------------+