docs-v2/content/flux/v0.x/stdlib/strings/totitle.md

59 lines
1.3 KiB
Markdown

---
title: strings.toTitle() function
description: The strings.toTitle() function converts all characters in a string to title case.
aliases:
- /influxdb/v2.0/reference/flux/functions/strings/totitle/
- /influxdb/v2.0/reference/flux/stdlib/strings/totitle/
- /influxdb/cloud/reference/flux/stdlib/strings/totitle/
menu:
flux_0_x_ref:
name: strings.toTitle
parent: strings
weight: 301
related:
- /flux/v0.x/stdlib/strings/toupper
- /flux/v0.x/stdlib/strings/tolower
- /flux/v0.x/stdlib/strings/title
introduced: 0.18.0
---
The `strings.toTitle()` function converts all characters in a string to title case.
_**Output data type:** String_
```js
import "strings"
strings.toTitle(v: "a flux of foxes")
// returns "A FLUX OF FOXES"
```
## Parameters
### v {data-type="string"}
The string value to convert.
## Examples
###### Covert characters in a string to title case
```js
import "strings"
data
|> map(fn: (r) => ({ r with pageTitle: strings.toTitle(v: r.pageTitle) }))
```
{{% note %}}
#### The difference between toTitle and toUpper
The results of `toTitle()` and `toUpper` are often the same, however the difference
is visible with special characters:
```js
str = "dz"
strings.toTitle(v: str) // Returns Dz
strings.toUpper(v: str) // Returns DZ
```
{{% /note %}}