Função LTRIM() no Oracle

No Oracle, o LTRIM() A função permite aparar a parte esquerda 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:

LTRIM(char [, set ])

Onde char e set pode ser qualquer um dos tipos de dados CHAR , VARCHAR2 , NCHAR , NVARCHAR2 , CLOB , ou NCLOB .

LTRIM remove da extremidade esquerda 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 simples para demonstrar:

SELECT LTRIM('     Cat')
FROM DUAL;

Resultado:

   LTRIM('CAT') 
_______________ 
Cat

Nesse caso, não especifiquei quais caracteres aparar e, portanto, cada espaço em branco foi cortado da parte esquerda da string.

Aqui está novamente quando comparado com a string original (sem preenchimento):

SELECT '     Cat'
FROM DUAL
UNION ALL
SELECT LTRIM('     Cat')
FROM DUAL;

Resultado:

      'CAT' 
___________ 
     Cat    
Cat

Especifique um caractere

Neste exemplo, especifico um caractere para aparar:

SELECT LTRIM('...Cat...', '.')
FROM DUAL;

Resultado:

   LTRIM('...CAT...','.') 
_________________________ 
Cat...

Assim, podemos ver que o personagem foi cortado do lado esquerdo, mas não do lado direito. Para cortar o lado direito, use RTRIM() ou TRIM() .

Observe que LTRIM() 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 LTRIM('...A...Cat', '.')
FROM DUAL;

Resultado:

   LTRIM('...A...CAT','.') 
__________________________ 
A...Cat

No entanto, se incluirmos A no conjunto, obtemos um resultado diferente:

SELECT LTRIM('...A...Cat', '.A')
FROM DUAL;

Resultado:

   LTRIM('...A...CAT','.A') 
___________________________ 
Cat

Exemplo de banco de dados

Aqui está um exemplo de corte da parte esquerda dos valores em uma coluna de banco de dados:

SELECT 
    country_name,
    LTRIM(country_name, 'Ar') AS Trimmed
FROM countries
FETCH FIRST 5 ROWS ONLY;

Resultado:

   COUNTRY_NAME     TRIMMED 
_______________ ___________ 
Argentina       gentina     
Australia       ustralia    
Belgium         Belgium     
Brazil          Brazil      
Canada          Canada

Valores nulos

Se algum dos argumentos for null o resultado é null :

SET NULL 'null';

SELECT 
    LTRIM(null, 3),
    LTRIM(' Cat', null),
    LTRIM(null, null)
FROM DUAL;

Resultado:

   LTRIM(NULL,3)    LTRIM('CAT',NULL)    LTRIM(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 LTRIM('   Cat', '')
FROM DUAL;

Resultado:

   LTRIM('CAT','') 
__________________ 
null

Mas adicionar um único espaço à string vazia muda isso e corta todos os espaços em branco da esquerda da string:

SELECT LTRIM('   Cat', ' ')
FROM DUAL;

Resultado:

   LTRIM('CAT','') 
__________________ 
Cat

Contagem incorreta de argumentos

Chamando LTRIM() sem passar nenhum argumento retorna um erro:

SELECT LTRIM()
FROM DUAL;

Resultado:

Error starting at line : 1 in command -
SELECT LTRIM()
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 LTRIM('Cat', 1, '>')
FROM DUAL;

Resultado:

Error starting at line : 1 in command -
SELECT LTRIM('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: