No Oracle, o
RTRIM()
A função permite aparar a parte direita de uma string. Por padrão, ele apara o espaço em branco, mas você pode especificar opcionalmente um caractere ou caracteres diferentes para aparar. Sintaxe
A sintaxe fica assim:
RTRIM(char [, set ])
Onde
char
e set
pode ser qualquer um dos tipos de dados CHAR
, VARCHAR2
, NCHAR
, NVARCHAR2
, CLOB
, ou NCLOB
. RTRIM
remove da extremidade direita de char
todos os caracteres contidos em set
. Se você não especificar set
, o padrão é um único espaço em branco. Exemplo
Aqui está um exemplo:
SELECT RTRIM('Cat ')
FROM DUAL;
Resultado:
RTRIM('CAT') _______________ Cat
Aqui, eu não especifiquei qual(is) caractere(s) aparar e, portanto, cada espaço em branco foi cortado da parte direita da string.
Não é fácil ver o efeito do exemplo acima.
Aqui está outro exemplo, com a string sendo concatenada com outra string, enquanto compara a saída com a string original (não cortada):
SELECT 'Cat ' || 'Food'
FROM DUAL
UNION ALL
SELECT RTRIM('Cat ') || 'Food'
FROM DUAL;
Resultado:
'CAT'||'FOOD' ________________ Cat Food CatFood
Especifique um caractere
Neste exemplo, especifico um caractere para aparar. Isso torna mais fácil ver o efeito:
SELECT RTRIM('...Cat...', '.')
FROM DUAL;
Resultado:
RTRIM('...CAT...','.') _________________________ ...Cat
Assim, podemos ver que o personagem foi cortado do lado direito, mas não do lado esquerdo. Para cortar o lado esquerdo, use
LTRIM()
ou TRIM()
. Observe que
RTRIM()
apenas corta o(s) caractere(s) na configuração até que haja um personagem que não esteja no conjunto. Aqui está um exemplo do que quero dizer:SELECT RTRIM('Cat...B...', '.')
FROM DUAL;
Resultado:
RTRIM('CAT...B...','.') __________________________ Cat...B
No entanto, se incluirmos
B
no conjunto, obtemos um resultado diferente:SELECT RTRIM('Cat...B...', '.B')
FROM DUAL;
Resultado:
RTRIM('CAT...B...','.B') ___________________________ Cat
Exemplo de banco de dados
Aqui está um exemplo de corte da parte direita dos valores em uma coluna de banco de dados:
SELECT
country_name,
RTRIM(country_name, 'an') AS Trimmed
FROM countries
FETCH FIRST 5 ROWS ONLY;
Resultado:
COUNTRY_NAME TRIMMED _______________ ___________ Argentina Argenti Australia Australi Belgium Belgium Brazil Brazil Canada Canad
Valores nulos
Se algum argumento for
null
o resultado é null
:SET NULL 'null';
SELECT
RTRIM(null, 3),
RTRIM('Cat ', null),
RTRIM(null, null)
FROM DUAL;
Resultado:
RTRIM(NULL,3) RTRIM('CAT',NULL) RTRIM(NULL,NULL) ________________ ____________________ ___________________ null null null
Por padrão, SQLcl e SQL*Plus retornam um espaço em branco sempre que
null
ocorre como resultado de um SQL SELECT
demonstração. No entanto, você pode usar
SET NULL
para especificar uma string diferente a ser retornada. Aqui eu especifiquei que a string null
deve ser devolvido. Cortando Strings Vazias
Passar uma string vazia como segundo argumento resulta em
null
:SET NULL 'null';
SELECT RTRIM('Cat ', '')
FROM DUAL;
Resultado:
RTRIM('CAT','') __________________ null
Mas adicionar um único espaço à string vazia muda isso e corta todos os espaços em branco da direita da string:
SELECT RTRIM('Cat ', ' ')
FROM DUAL;
Resultado:
RTRIM('CAT','') __________________ Cat
Contagem incorreta de argumentos
Chamando
RTRIM()
sem passar nenhum argumento retorna um erro:SELECT RTRIM()
FROM DUAL;
Resultado:
Error starting at line : 1 in command - SELECT RTRIM() FROM DUAL Error at Command Line : 1 Column : 8 Error report - SQL Error: ORA-00938: not enough arguments for function 00938. 00000 - "not enough arguments for function" *Cause: *Action:
E passar o número errado de argumentos resulta em um erro:
SELECT RTRIM('Cat', 1, '>')
FROM DUAL;
Resultado:
Error starting at line : 1 in command - SELECT RTRIM('Cat', 1, '>') FROM DUAL Error at Command Line : 1 Column : 8 Error report - SQL Error: ORA-00939: too many arguments for function 00939. 00000 - "too many arguments for function" *Cause: *Action: