Compares two strings in lower-case and returns the difference indicator (see table below) as an integer value.

Syntax

int utf8.ncasecmp ( string a, string b )

Required Arguments

• a: A string character sequence.
• b: A string character sequence.

Returns

• int: value
  • -1: a < b
  • 0: a == b
  • 1: a > b

Returns an integer, which indicates the difference, see the table above for further information.

Code Examples

Example 1 Example 2

shared

This example shows a simple comparsion of two different strings.

local a = "Hello"
local b = "World"
local result = utf8.ncasecmp(a, b)

if result == -1 then
    print("a < b") -- printed
elseif result == 0 then
    print("a == b")
elseif result == 1 then
    print("a > b")
end

server

This example shows how to greet a player, when he write 'hello' into the chat.

addEventHandler("onPlayerChat", root, function(message, messageType)
    if messageType == 0 and utf8.ncasecmp(message, "hello") == 0 then
        outputChatBox("* Server: Hello!", source, 255, 100, 100)
    end
end)

See Also

UTF8 Library Functions

• 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

Reference

• Scripting Functions