Função NLS_INITCAP() no Oracle

No Oracle, o NLS_INITCAP() A função retorna seu argumento com a primeira letra de cada palavra em maiúscula e todas as outras letras em minúsculas.

No entanto, a capitalização real dependerá do agrupamento que está sendo usado. Por exemplo, pode resultar em mais do que a primeira letra maiúscula.

É semelhante ao INITCAP() função, exceto que ela aceita um segundo argumento que permite especificar o agrupamento. O agrupamento lida com requisitos linguísticos especiais para conversões de maiúsculas e minúsculas.

Sintaxe

A sintaxe fica assim:

NLS_INITCAP(char [, 'nlsparam' ])

Onde ambos char e 'nlsparam' pode ser qualquer um dos tipos de dados CHAR , VARCHAR2 , NCHAR , ou NVARCHAR2 .

O 'nlsparam' argumento pode ter a seguinte forma:

'NLS_SORT = sort'

Onde sort é um agrupamento nomeado.

Se você omitir esse argumento, o agrupamento determinado da função será usado.

Exemplo

Aqui está um exemplo simples para demonstrar:

SELECT NLS_INITCAP('the lake')
FROM DUAL;

Resultado:

   NLS_INITCAP('THELAKE') 
_________________________ 
The Lake

Especificar um agrupamento

Aqui está um exemplo que demonstra como especificar um agrupamento pode alterar os resultados:

SELECT 
    NLS_INITCAP('het ijsselmeer') AS c1,
    NLS_INITCAP('het ijsselmeer', 'NLS_SORT = XDutch') AS c2
FROM DUAL;

Resultado:

               C1                C2 
_________________ _________________ 
Het Ijsselmeer    Het IJsselmeer

Observe que na segunda coluna, as duas primeiras letras de IJsselmeer são maiúsculas, enquanto a primeira coluna só coloca a primeira letra em maiúscula.

Em holandês, ij é considerado como uma letra e, portanto, ambos os caracteres são capitalizados quando ocorrem no início de uma frase ou de um nome próprio.

Observe que NLS_SORT substitui o agrupamento do primeiro argumento apenas no momento da execução. Portanto, a instrução a seguir retorna o agrupamento do primeiro argumento, não o segundo:

SELECT
    COLLATION(NLS_INITCAP('het IJsselmeer', 'NLS_SORT = XDutch')) AS Collation
FROM DUAL;

Resultado:

        COLLATION 
_________________ 
USING_NLS_COMP

O assunto dos agrupamentos pode ser bastante complexo. Consulte o Apêndice C no Oracle Database Globalization Support Guide para obter as regras de determinação de ordenação e as regras de derivação de ordenação para esta função.

E se eu passar em todas as letras maiúsculas?

Passar todas as letras maiúsculas não altera o resultado:

SELECT 
    NLS_INITCAP('HET IJSSELMEER', 'NLS_SORT = XDutch') AS Result
FROM DUAL;

Resultado:

           RESULT 
_________________ 
Het IJsselmeer

Valores nulos

Se algum argumento for null , o resultado é null :

SET NULL 'null';

SELECT 
    NLS_INITCAP('het IJsselmeer', null) AS r1,
    NLS_INITCAP(null, 'NLS_SORT = XDutch') AS r2,
    NLS_INITCAP(null, null) AS r3
FROM DUAL;

Resultado:

     R1      R2      R3 
_______ _______ _______ 
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.

Contagem incorreta de argumentos

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

SELECT NLS_INITCAP()
FROM DUAL;

Resultado:

Error starting at line : 1 in command -
SELECT NLS_INITCAP()
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 NLS_INITCAP('het IJsselmeer', 'NLS_SORT = XDUTCH', 3)
FROM DUAL;

Resultado:

Error starting at line : 1 in command -
SELECT NLS_INITCAP('het IJsselmeer', 'NLS_SORT = XDUTCH', 3)
FROM DUAL
Error at Command Line : 1 Column : 59
Error report -
SQL Error: ORA-00939: too many arguments for function
00939. 00000 -  "too many arguments for function"
*Cause:    
*Action: