Categorias:

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

RTRIM

Remove os caracteres finais, à direita, 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:

LTRIM , TRIM

Sintaxe

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

Argumentos

expr

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

characters

Um ou mais caracteres a serem removidos do lado direito 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 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 0 e . no final de uma cadeia de caracteres:

SELECT RTRIM('$125.00', '0.');
Copy
+------------------------+
| RTRIM('$125.00', '0.') |
|------------------------|
| $125                   |
+------------------------+

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_rtrim_function(column1 VARCHAR);

INSERT INTO test_rtrim_function VALUES ('Trailing Spaces#  ');
Copy

Remover o espaço em branco no final 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(RTRIM(column1), '<')) AS trimmed_value
  FROM test_rtrim_function;
Copy
+----------------------+--------------------+
| ORIGINAL_VALUE       | TRIMMED_VALUE      |
|----------------------+--------------------|
| >Trailing Spaces#  < | >Trailing 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(RTRIM(column1, '# '), '<')) AS trimmed_value
  FROM test_rtrim_function;
Copy
+----------------------+-------------------+
| ORIGINAL_VALUE       | TRIMMED_VALUE     |
|----------------------+-------------------|
| >Trailing Spaces#  < | >Trailing Spaces< |
+----------------------+-------------------+
Linguagem: Português