Overview
/
KCL Standard Library
/
Functions
/
string::lowercase

string::lowercaseFunction in std::string

Convert all cased characters in a string to lowercase.

This conversion is Unicode-aware and locale-independent. Some conversions depend on the surrounding characters; for example, a Greek capital sigma becomes ς at the end of a word and σ elsewhere. Some characters expand into multiple characters; for example, İ becomes i followed by a combining dot above. The exact mappings follow the Unicode data bundled with KCL.

Unicode normalization is not performed. Canonically equivalent strings therefore retain their original representations. Empty strings and strings without cased characters are returned unchanged.

Arguments

NameTypeDescriptionRequired
textstringThe string to convert.Yes

Returns

string - A sequence of characters

Examples