Converts a UTF-8 string to folded case (lowercase), which can be used to compare two strings. If input is an integer, it's treat as a codepoint and a convert codepoint (integer) is returned.

Note

You may want to read up on case folding for more information about the use of this function.

Syntax

string|int utf8.fold ( string|int input )

Required Arguments

• input: A string character sequence OR an integer value.

Returns

• string|int: value

Returns a string in lowercase OR returns an integer (see description).

Second Syntax

string|int utf8.lower ( string|int input )

Code Examples

shared

This example shows how to convert a string to lowercase, which can be used to compare with other folded strings.

local output = utf8.lower("WHAT ARE YOU UP TO? Do you like uppercase?")
print(output) -- what are you up to? do you like uppercase?

local value = utf8.fold(1088)
print(type(value)) -- number

See Also

UTF8 Library Functions

• utf8.byte
• utf8.char
• utf8.charpos
• utf8.escape
• utf8.find
• utf8.fold
• utf8.gmatch
• utf8.gsub
• utf8.insert
• utf8.len
• utf8.lower
• utf8.match
• utf8.ncasecmp
• utf8.next
• utf8.remove
• utf8.reverse
• utf8.sub
• utf8.title
• utf8.upper
• utf8.width
• utf8.widthindex

Reference

• Scripting Functions