Utf8.escape: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
mNo edit summary |
||
(3 intermediate revisions by the same user not shown) | |||
Line 2: | Line 2: | ||
{{Shared function}} | {{Shared function}} | ||
Escapes a string to a UTF-8 format string. It supports several escape formats | Escapes a string to a UTF-8 format string. It supports several escape formats, see the formatting table. | ||
==Syntax== | ==Syntax== | ||
Line 19: | Line 12: | ||
===Returns=== | ===Returns=== | ||
Returns a ''string'' containing the escaped UTF-8 characters from the original string. | Returns a ''string'' containing the escaped UTF-8 characters from the original string. | ||
===Formatting=== | |||
{| class="prettytable" style="width:35%;text-align:left;" | |||
|- | |||
! Format || Description | |||
|- | |||
| '''%ddd''' || ddd is a decimal number with variable length | |||
|- | |||
| '''%{ddd}''' || same as above, but enclosed in brackets | |||
|- | |||
| '''%uddd''' || same as '''%ddd''', 'u' stands for unicode | |||
|- | |||
| '''%u{ddd}''' || same as above, but enclosed in brackets | |||
|- | |||
| '''%xhhh''' || hexadigit version of '''%ddd''' | |||
|- | |||
| '''%x{hhh}''' || same as above, but enclosed in brackets | |||
|- | |||
| '''%?''' || '?' stands for any other character to be escaped | |||
|} | |||
==Example== | ==Example== | ||
<section name="Server" class="server" show="true"> | <section name="Server" class="server" show="true"> | ||
This example escapes two byte-string literals to UTF-8 format by using the utf8.escape function. | |||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
local output = utf8.escape( "%123 %u123 %{123} %u{123} %xABC %x{ABC}" ) | local output = utf8.escape( "%123 %u123 %{123} %u{123} %xABC %x{ABC}" ) |
Latest revision as of 18:34, 15 February 2016
Escapes a string to a UTF-8 format string. It supports several escape formats, see the formatting table.
Syntax
string utf8.escape ( string input )
Required Arguments
- input: A string character sequence
Returns
Returns a string containing the escaped UTF-8 characters from the original string.
Formatting
Format | Description |
---|---|
%ddd | ddd is a decimal number with variable length |
%{ddd} | same as above, but enclosed in brackets |
%uddd | same as %ddd, 'u' stands for unicode |
%u{ddd} | same as above, but enclosed in brackets |
%xhhh | hexadigit version of %ddd |
%x{hhh} | same as above, but enclosed in brackets |
%? | '?' stands for any other character to be escaped |
Example
Click to collapse [-]
ServerThis example escapes two byte-string literals to UTF-8 format by using the utf8.escape function.
local output = utf8.escape( "%123 %u123 %{123} %u{123} %xABC %x{ABC}" ) print( output ) -- { { { { ઼ ઼ local output = utf8.escape( "%%123 %? %d %%u" ) print( output ) -- %123 ? d %u
See Also
Shared
- 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