Categorias:

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

TRIM

Remove os caracteres iniciais e finais de uma cadeia de caracteres.

Consulte também

LTRIM , RTRIM

Sintaxe

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

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 único caractere de espaço em branco), ou seja, se nenhum caractere for especificado, todos os espaços em branco no início e no final são removidos.

Notas de uso

  • Os caracteres em characters podem ser especificados em qualquer ordem.

  • Para remover espaços em branco, os caracteres devem ser explicitamente incluídos no argumento. Por exemplo, ' $.' remove todos os espaços em branco no início e no final, sinais de dólar e períodos da cadeia de caracteres de entrada.

    Observe que isso não remove outros caracteres do espaço em branco (caracteres de tabulação, caracteres de fim de linha etc.), que também devem ser explicitamente especificados.

Detalhes do agrupamento

O agrupamento é suportado quando o segundo argumento opcional é omitido, ou quando ele contém apenas espaço em branco constante.

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 TRIM('❄-❄ABC-❄-', '❄-');

-------------------------+
 TRIM('❄-❄ABC-❄-', '❄-') |
-------------------------+
 ABC                     |
-------------------------+
Copy

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:

SELECT CONCAT('>', CONCAT(v, '<')), CONCAT('>', CONCAT(TRIM(v), '<')) FROM tr;

-----------------------------+-----------------------------------+
 concat('>', concat(v, '<')) | concat('>', concat(trim(v), '<')) |
-----------------------------+-----------------------------------+
 >  <                        | ><                                |
 >  asd  <                   | >asd<                             |
 >  asd<                     | >asd<                             |
 >  éché, la lé  <           | >éché, la lé<                     |
 > <                         | ><                                |
 ><                          | ><                                |
 >asd  <                     | >asd<                             |
 [NULL]                      | [NULL]                            |
-----------------------------+-----------------------------------+
Copy