INITCAP Função escalar

A função INITCAP retorna uma string com o primeiro caractere de cada palavra convertida em maiústica, usando a semântica de função UPPER, e os outros caracteres convertidos para minúsculas, usando a semântica de função LOWER.

Read syntax diagramSkip visual syntax diagramINITCAP(string-expression )

O esquema é SYSIBM.

Uma palavra é delimitada por qualquer um dos seguintes caracteres:
Tabela 1. Caracteres delimitadores de palavras
Caráter ou gama de caracteres Pontos de código Unicode ou gama de pontos de código Unicode
(em branco) U+0020
! " # $ % & ' ( ) * + , -. / U+0021 para U+002F
: ; < = > ? @ U+003A para U+0040
[ \ ] ^ _ ` U+005B para U+0060
{ | } ~ U+007B para U+007E
Caracteres de controle, incluindo os seguintes caracteres de controle SQL:
  • tabulação
  • nova linha
  • feed de formulário
  • retorno de linha
  • feed de linha
U+0009, U+000A, U+000B, U+000C, U+000D, U+0085
Nota: Um caractere listado na tabela precedente pode não ter um ponto de código alocado em uma determinada página de código de banco de dados.
string-expression
Uma expressão que retorna um tipo de dados CHAR ou VARCHAR. Em um banco de dados Unicode, a expressão pode retornar um tipo de dados GRAPHIC ou VARGRAPHIC.
O tipo de dado do resultado depende do tipo de dados de string-expression, conforme descrito na tabela a seguir:
Tabela 2. Tipo de dados de expressão string comparada com o tipo de dado do resultado
Tipo de dados de string-expression Tipo de dado do resultado
Char ou Varchar VARCHAR
GRÁFICO ou VARGRAPHIC VARGRAPHIC
O atributo length do resultado é o mesmo que o atributo length de string-expression.

Se o argumento pode ser nulo, o resultado pode ser nulo; se o argumento for nulo, o resultado será o valor nulo.

Exemplos

  • Exemplo 1: Entrada a string um título de livro prospectivo para retornar a string Um Título de Livro Prospectivo.
    VALUES INITCAP ('a prospective book title')
    1 
    ------------------------
    A Prospective Book Title  
  • Exemplo 2: Entrada a string YOUR NAME para retornar a string Seu Nome.
    VALUES INITCAP ('YOUR NAME') 
    1 
    ---------
    Your Name  
  • Exemplo 3: Entrada a string my_résumé para retornar a string My_Résumé.
    VALUES INITCAP ('my_résumé')
    1 
    --------- 
    My_Résumé
  • Exemplo 4: Entrada a string élégant para retornar a string Élégant.
    VALUES INITCAP ('FORMAT:élégant')  
    1 
    -------------- 
    Format:Élégant