# Capitalize - Função de script e de gráfico

A função do Capitalize() returns the string with all words in initial uppercase letters. converte o primeiro caractere de cada palavra em uma string de texto em maiúsculas e converte todos os outros caracteres em minúsculas.

Sintaxe:

Capitalize(text)

Tipo de dados de retorno: caractere

Argumentos

| Argumento | Descrição |
| --- | --- |
| text | A string a ser avaliada. |

Exemplo: expressões de gráfico

| Exemplo | Resultado |
| --- | --- |
| `Capitalize( 'star trek' )` | Retorna `Star Trek` |
| `Capitalize( 'AA bb cC Dd' )` | Retorna `Aa Bb Cc Dd` |

## Exemplo - Fundamentos da capitalização

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Capitalize.htm)

#### Expressão de gráfico

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.

* Um campo na tabela de dados chamado `TextToCapitalize`.

Script de carregamento

```
Example:
Load * inline [
TextToCapitalize
50 Cent
a-ha
BIGBANG
girl in red
];
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:

* ` TextToCapitalize
                                   `

Crie a seguinte dimensão calculada:

* `=Capitalize(TextToCapitalize)` para calcular quais caracteres devem ter letras maiúsculas.

Tabela de resultados

| TextToCapitalize | Capitalize(TextToCapitalize) |
| --- | --- |
| 50 Cent | 50 Cent |
| a-ha | A-Ha |
| BIGBANG | Bigbang |
| girl in red | Girl In Red |

Não há nenhuma alteração na primeira linha de dados, pois o primeiro conjunto de caracteres começa com um número e o segundo já está em maiúsculas.

Na segunda linha, o primeiro e o terceiro caracteres são maiúsculos.

Na terceira linha, apenas a primeira letra é maiúscula, e todas as letras subsequentes são definidas como minúsculas.

Na quarta linha, a primeira letra de cada palavra está em maiúscula.

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Capitalize.htm)

#### Script de carregamento

O código a seguir mostra como usar a função em um script de carregamento.

```
Load 
String,
Capitalize(String)
Inline
[String
rHode iSland
washingTon d.C.
new york];
```

Tabela de resultados

| Cadeia | Capitalize(String) |
| --- | --- |
| rHode iSland | Rhode Island |
| washingTon d.C. | Washington D.C. |
| new york | New York |

## Exemplo - Cenário de capitalização

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Capitalize.htm)

#### Expressão de gráfico

Visão geral

Um conjunto de dados de nomes de clientes é inserido usando vários formatos, como tudo em minúsculas, tudo em maiúsculas ou letras maiúsculas e minúsculas. A função `Capitalize` é usada para limpar os dados de modo que o nome e o sobrenome do cliente fiquem corretamente em maiúsculas quando exibidos no painel.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.

* Um campo na tabela de dados chamado `CustomerName`.

Script de carregamento

```
Example:
Load * inline [
CustomerName
john smith
JANE DOE
miCHAel Brown
];
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:

* `CustomerName`

Crie a seguinte dimensão calculada:

* `=Capitalize(CustomerName)` para usar os nomes dos clientes em maiúsculas.

Tabela de resultados

| CustomerName | Capitalize(CustomerName) |
| --- | --- |
| JANE DOE | Jane Doe |
| john smith | John Smith |
| miCHAel Brown | Michael Brown |

Compare a saída da função `Capitalize` com os valores originais da string `CustomerName` que foram carregados no script. Você pode ver como a função converteu com sucesso os nomes para que usem maiúsculas e minúsculas corretamente. A exibição de nomes de clientes com capitalização padronizada melhora a aparência, a consistência e a legibilidade do painel.