Generates a string representing the character codepoints as arguments.

Syntax

​string utf8.char ( ​int codepoints... )

Required arguments

• codepoints...: An variable argument sequence of code points representing the desired unicode characters.

Returns

Returns a string representation of the codepoints passed.

• string: value

Code Examples

Example 1 Example 2 Example 3

shared

This example separates an input string into single codepoints and then joins these back together, representing the original input string.

local input = "Hello World"
local codepoints = {utf8.byte(input, 1, utf8.len(input))}
local joined = utf8.char(unpack(codepoints))

print(joined) -- Hello World

shared

This example takes three code points to generate the string "MTA".

local mta = utf8.char(77, 84, 65)
print(mta) -- MTA

shared

This example takes the first five code points from the input string and then joins them back together.

local input = "Mutli Theft Auto"
local codepoints = {}

-- Extract first 5 characters (read: Mutli)
for index = 1, 5 do
    codepoints[index] = utf8.byte(input, index)
end

local output = ""

-- Join the first 5 characters together
for index = 1, #codepoints do
    output = output .. utf8.char(codepoints[index])
end

outputConsole(output) -- Multi

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