# Capitalize Функция скрипта и диаграммы

Функция Capitalize() переводит первый символ каждого слова в текстовой строке в верхний регистр и переводит все остальные символы в нижний регистр.

Синтаксис:

Capitalize(text)

Возвращаемые типы данных: строка

Аргументы

| Аргумент | Описание |
| --- | --- |
| text | Текстовая строка для оценки. |

Пример: выражения диаграммы

| Пример | Результат |
| --- | --- |
| `Capitalize( 'star trek' )` | Возвращает `Star Trek` |
| `Capitalize( 'AA bb cC Dd' )` | Возвращает `Aa Bb Cc Dd` |

## Пример. Основы использования функции Capitalize

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

#### Выражение диаграммы

Обзор

Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел.

Скрипт загрузки содержит следующее:

* Набор данных, который загружается в таблицу данных под именем `Example`.

* Одно поле в таблице данных называется `TextToCapitalize`.

Скрипт загрузки

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

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте это поле как измерение:

* ` TextToCapitalize
                                   `

Создайте следующее вычисляемое измерение:

* `=Capitalize(TextToCapitalize)`, чтобы вычислить, какие символы следует писать заглавными буквами.

Результирующая таблица

| ТекстДляЗаглавныхБукв | СделатьЗаглавными(ТекстДляЗаглавныхБукв) |
| --- | --- |
| 50 Cent | 50 Cent |
| a-ha | A-Ha |
| BIGBANG | Bigbang |
| girl in red | Girl In Red |

В первой строке данных нет никаких изменений, поскольку первый набор символов начинается с цифры, а второй уже написан заглавными буквами.

Во второй строке первый и третий символы заглавные.

В третьей строке только первая буква заглавная, а все последующие определены как строчные.

В четвертой строке первая буква каждого слова пишется с заглавной буквы.

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

#### Скрипт загрузки

Следующий код показывает, как использовать эту функцию в скрипте загрузки.

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

Результирующая таблица

| Строка | СделатьЗаглавной(Строка) |
| --- | --- |
| rHode iSland | Rhode Island |
| washingTon d.C. | Washington D.C. |
| new york | New York |

## Пример. Сценарий использования функции Capitalize

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

#### Выражение диаграммы

Обзор

Набор данных с именами клиентов вводится в различных форматах, например, все строчные, все прописные или смешанный регистр. Функция `Capitalize` используется для очистки данных, чтобы имя и фамилия клиента были правильно написаны заглавными буквами при отображении на информационной панели.

Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел.

Скрипт загрузки содержит следующее:

* Набор данных, который загружается в таблицу данных под именем `Example`.

* Одно поле в таблице данных называется `CustomerName`.

Скрипт загрузки

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

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте это поле как измерение:

* `CustomerName`

Создайте следующее вычисляемое измерение:

* `=Capitalize(CustomerName)`, чтобы имена клиентов начинались с заглавной буквы.

Результирующая таблица

| CustomerName | СделатьЗаглавной(ИмяКлиента) |
| --- | --- |
| ДЖЕЙН ДОУ | Джейн Доу |
| джон смит | Джон Смит |
| Майкл Браун | Майкл Браун |

Сравните вывод функции `Capitalize` с исходными значениями строк `CustomerName`, загруженными в скрипт. Мы видим, как функция успешно преобразовала имена в нужный регистр. Отображение имен клиентов со стандартным использованием заглавных букв улучшает внешний вид, согласованность и читабельность информационной панели.