Utf8.char

Generates a string representing the character codepoints as arguments.

Syntax

string utf8.char ( [ int codepoints... ] )

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

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

Returns

Returns a string representation of the codepoints passed.

Example

Click to collapse [-]

Server

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

Click to collapse [-]

Server

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

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

Click to collapse [-]

Client

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.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