Sumário

Search

  1. Prefácio
  2. A Linguagem de Transformação
  3. Constantes
  4. Operadores
  5. Variáveis
  6. Datas
  7. Funções
  8. Criação de funções personalizadas
  9. Referência de API da Função Personalizada

Referência de Linguagem de Transformação

Referência de Linguagem de Transformação

RTRIM

RTRIM

Remove espaços em branco ou caracteres do final de uma string.
Se você não especificar um parâmetro
trim_set
na expressão:
  • No modo UNICODE, RTRIM remove espaços de byte único e duplo do final de uma string.
  • No modo ASCII, RTRIM remove apenas espaços de byte único.
Se você usar RTRIM para remover caracteres de uma string, RTRIM compara o
trim_set
a cada caractere no argumento
string
, caractere-por-caractere, a partir do lado direito da string. Se o caractere na string corresponder a qualquer caractere no
trim_set
, RTRIM o removerá. RTRIM continua a comparar e remover caracteres até que ele não consiga encontrar um caractere correspondente no
trim_set
. Ele retorna a string sem os caracteres correspondentes.

Sintaxe

RTRIM(
string
[,
trim_set
] )
A tabela a seguir descreve os argumentos para este comando:
Argumento
Requerido/
Opcional
Descrição
string
Requerido
Qualquer valor de string. Passa os valores que você deseja cortar. Você pode inserir qualquer expressão de transformação válida. Use operadores para executar comparações ou concatenar string antes de remover espaços em branco a partir do final de uma string.
trim_set
Opcional
Qualquer valor de string. Passa os caracteres que você deseja remover a partir do final da string. Você também pode inserir um literal de texto. No entanto, você deve anexar os caracteres que deseja remover do final da string entre aspas simples, por exemplo, 'abc'. Se você omitir a segunda string, a função removerá espaços em branco no final da primeira string.
RTRIM diferencia maiúsculas de minúsculas.

Valor de Retorno

String. Os valores de string com os caracteres especificados no argumento
trim_set
removido.
NULL se um valor transmitido para a função for NULL.

Exemplo

A seguinte expressão remove os caracteres ‘re’ das strings na porta LAST_NAME:
RTRIM( LAST_NAME, 're')
LAST_NAME
RETURN VALUE
Nelson
Nelson
Page
Pag
Osborne
Osborn
NULL
NULL
Sawyer
Sawy
H. Bender
H. Bend
Steadman
Steadman
RTRIM removerá ‘e’ da Página mesmo se ‘r’ for o primeiro caractere no
trim_set
. Isso porque RTRIM pesquisa, caractere-por-caractere, o conjunto de caracteres que você especifica no argumento
trim_set
. Se o último caractere na string corresponder ao primeiro caractere no
trim_set
, RTRIM o removerá. Porém, se o último caractere na string não corresponder, RTRIM comparará o segundo caractere no
trim_set
. Se o segundo do último caractere na string corresponder ao segundo caractere no
trim_set
, RTRIM o removerá. Quando o caractere na string não corresponder ao
trim_set
, RTRIM retornará a string e avaliará a próxima linha.
No último exemplo, o último caractere em Nelson não corresponde a nenhum caractere no argumento
trim_set
, assim RTRIM retorna a string 'Nelson' e avalia a próxima linha.

Dicas para RTRIM

Use RTRIM e LTRIM com || ou CONCAT para remover espaços em branco à direita e à esquerda depois de concatenar duas strings.
Você também pode remover vários conjuntos de caracteres ao aninhar RTRIM. Por exemplo, se quiser remover espaços em branco à esquerda e o caractere 't' do final de cada string em uma coluna de nomes, você poderá criar uma expressão semelhante ao seguinte:
RTRIM( RTRIM( NAMES ), 't' )