Utf8.char

From Multi Theft Auto: Wiki
Jump to: navigation, search

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