---
title: "toLowerCase"
description: "Returns lowercase transformed String."
type: "function"
---

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


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


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


Returns lowercase transformed String.

#### Parameters

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


#### Returns

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




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


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


Returns lowercase transformed String.

#### Parameters

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


#### Returns

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




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


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


Create lower case transformed `AnnotatedString`

The lowercase 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 lowercase mapping 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 lower case mapping. Only the first locale is effective. If empty locale list is passed, use the current locale instead. |


#### Returns

| | |
| --- | --- |
|  | A lowercase transformed string. |