---
title: "decapitalize"
description: "Returns decapitalized String."
type: "function"
---

<div class='type'>Function</div>


<a id='references'></a>
<div class='sourceset sourceset-common'>Common</div>


```kotlin
fun String.decapitalize(locale: Locale): String
```


Returns decapitalized String.

#### Parameters

| | |
| --- | --- |
| locale | a locale object |


#### Returns

| | |
| --- | --- |
|  | a transformed text |




<div class='sourceset sourceset-common'>Common</div>


```kotlin
fun String.decapitalize(localeList: LocaleList): String
```


Returns decapitalized String.

#### Parameters

| | |
| --- | --- |
| localeList | a locale list object. If empty locale list object is passed, use current locale instead. |




<div class='sourceset sourceset-common'>Common</div>


```kotlin
fun AnnotatedString.decapitalize(localeList: LocaleList = LocaleList.current): AnnotatedString
```


Create capitalized `AnnotatedString`

The decapitalization sometimes maps different number of characters. This function adjusts the
text style and paragraph style ranges to transformed offset.

Note, if the style's offset is middle of the decapitalization context, this function won't
transform the character, e.g. style starts from between base alphabet character and accent
character.

#### Parameters

| | |
| --- | --- |
| localeList | A locale list used for decapitalize mapping. Only the first locale is effective. If empty locale list is passed, use the current locale instead. Note that, this locale is currently ignored since underlying Kotlin method is experimental. |


#### Returns

| | |
| --- | --- |
|  | A decapitalized string. |