Utf8.charpos - Revision history

Necktrox at 18:27, 15 February 2016

2016-02-15T18:27:13Z

← Older revision		Revision as of 18:27, 15 February 2016
Line 21:		Line 21:
	==Example==		==Example==
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	This example takes the second codepoint character and shows the byte-string position and the ~~code point~~ character code.		This example takes the second codepoint character and shows the byte-string position and the codepoint character code.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local position, codepoint = utf8.charpos( "Привет", 2 )		local position, codepoint = utf8.charpos( "Привет", 2 )

Necktrox at 18:26, 15 February 2016

2016-02-15T18:26:20Z

← Older revision		Revision as of 18:26, 15 February 2016
Line 17:		Line 17:

	===Returns===		===Returns===
	Returns the ''integer'' position as in a byte string and the ''integer'' ~~code point~~ at this position, ''nil'' otherwise.		Returns the ''integer'' position as in a byte string and the ''integer'' codepoint at this position, ''nil'' otherwise.

	==Example==		==Example==

Necktrox at 18:26, 15 February 2016

2016-02-15T18:26:04Z

← Older revision		Revision as of 18:26, 15 February 2016
Line 2:		Line 2:
	{{Shared function}}		{{Shared function}}

	Converts the UTF-8 ~~code point~~ position to byte-string position.		Converts the UTF-8 codepoint position to byte-string position.
	{{Note\|Code point characters beyond the byte value range (0-127) require at least 2 bytes to represent the character}}		{{Note\|Code point characters beyond the byte value range (0-127) require at least 2 bytes to represent the character}}

Line 13:		Line 13:
	===Optional Arguments===		===Optional Arguments===
	{{OptionalArg}}		{{OptionalArg}}
	*'''charpos:''' ~~A number~~ representing the beginning position (offset will be added/subtracted).		*'''charpos:''' An integer representing the beginning position (offset will be added/subtracted).
	*'''offset:''' ~~A number~~ representing the offset to charpos.		*'''offset:''' An integer representing the offset to charpos.

	===Returns===		===Returns===
	Returns the ''~~number~~'' position as in a byte string and the ''~~number~~'' code point at this position, ''nil'' otherwise.		Returns the ''integer'' position as in a byte string and the ''integer'' code point at this position, ''nil'' otherwise.

	==Example==		==Example==
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	This example takes the second ~~code point~~ character and shows the byte-string position and the code point character code.		This example takes the second codepoint character and shows the byte-string position and the code point character code.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local position, codepoint = utf8.charpos( "Привет", 2 )		local position, codepoint = utf8.charpos( "Привет", 2 )

Necktrox: Created page with "NOTOC {{Shared function}} Converts the UTF-8 code point position to byte-string position. {{Note|Code point characters beyond the byte value range (0-127) require at leas..."

2016-02-15T01:27:48Z

Created page with "__NOTOC__ {{Shared function}} Converts the UTF-8 code point position to byte-string position. {{Note|Code point characters beyond the byte value range (0-127) require at leas..."

New page

__NOTOC__
{{Shared function}}

Converts the UTF-8 code point position to byte-string position.
{{Note|Code point characters beyond the byte value range (0-127) require at least 2 bytes to represent the character}}

==Syntax==
<syntaxhighlight lang="lua">int, int utf8.charpos ( string input [[, int charpos = 0 ], int offset = 1 ] )</syntaxhighlight>

===Required Arguments===
*'''input:''' A string character sequence

===Optional Arguments===
{{OptionalArg}}
*'''charpos:''' A number representing the beginning position (offset will be added/subtracted).
*'''offset:''' A number representing the offset to charpos.

===Returns===
Returns the ''number'' position as in a byte string and the ''number'' code point at this position, ''nil'' otherwise.

==Example==
<section name="Server" class="server" show="true">
This example takes the second code point character and shows the byte-string position and the code point character code.
<syntaxhighlight lang="lua">
local position, codepoint = utf8.charpos( "Привет", 2 )
print( position, codepoint ) -- 3, 1088
</syntaxhighlight>
</section>
<section name="Client" class="client" show="true">
This example extracts the first character by calculating the character length with the UTF8 functions and the inbuilt Lua function string.sub, which processes byte strings.
<syntaxhighlight lang="lua">
local input = "Привет мир" -- Hello World
local from = utf8.charpos( input, 1 ) -- 1
local to = utf8.charpos( input, 2 ) -- 3

local byteLength = to - from
outputConsole( byteLength ) -- 2

local character = string.sub( input, from, byteLength )
outputConsole( character ) -- П
</syntaxhighlight>
</section>

==See Also==
{{UTF8 functions}}

Utf8.charpos - Revision history

Necktrox at 18:27, 15 February 2016

Necktrox at 18:26, 15 February 2016

Necktrox at 18:26, 15 February 2016

Necktrox: Created page with "__NOTOC__ {{Shared function}} Converts the UTF-8 code point position to byte-string position. {{Note|Code point characters beyond the byte value range (0-127) require at leas..."

Necktrox: Created page with "NOTOC {{Shared function}} Converts the UTF-8 code point position to byte-string position. {{Note|Code point characters beyond the byte value range (0-127) require at leas..."