View source for Utf8.len

__NOTOC__
{{Shared function}}

Returns the length of the string passed.

==Syntax==
<syntaxhighlight lang="lua">int utf8.len ( string input [, int i = 1, int j = utf8.len( input ) ] )</syntaxhighlight>

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

===Optional Arguments===
{{OptionalArg}}
*'''i:''' An integer representing the beginning position for measuring the length of the section (may be negative).
*'''j:''' An integer representing the ending position for measuring the length of the section (may be negative).

===Returns===
Returns the length of the string as an ''integer''.

==Example==
<section name="Client" class="client" show="true">
This example calculates the length of the input of the command /length and shows it in the chatbox.
<syntaxhighlight lang="lua">
addCommandHandler("length", 
    function (command, ...)
        local input = table.concat({...}, " ")

        if input then
            local length = utf8.len( input )
            outputChatBox( "* Length of your input: ".. length )
        end
    end
)
</syntaxhighlight>
</section>

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