====== How to search strings======

Now that you can receive messages and comments in VCI, there emerges a need to be able to search strings.
Here, we will explain two ways to search in strings.

  * Partial match search
  * Search a string that fulfills specific conditions

===== Use find() function to search for partial match =====

<file lua main.lua>
function onMessage(sender, name, message)

    -- content of the comment
    print(sender["name"].."\""..message.."\"")

    -- if the comment contains "lol" then true
    local lol = false
    if string.find(message,"lol") ~= nil then
        lol = true
    end

    if lol == true then
        print("A comment with lol in it was submitted")
    end
end

-- Receiving comments
vci.message.On('comment', onMessage)
</file>

The result
<code>
A comment with lol in it was submitted
(Search for "lol" with partial match)
</code>

The simplest way is to use ''string.find()'' to search in the message.

If the string to search was not found, it returns nil. If a match was found, it returns the position of the matching string.\\
In other words, if the search result of find() is not nil, that means the string to search for is included in the string.\\
For details of find(), refer to [[http://lua-users.org/wiki/StringLibraryTutorial|string.find()]].

===== Search with pattern match using match() function =====

Sometimes, there is a case when you want to find a string that matches a certain pattern, instead of a fixed string.\\
If that is the case, use Lua patterns to search in a string.

For details of match(), refer to [[http://lua-users.org/wiki/StringLibraryTutorial|string.match()]].\\
For details of Lua patterns, refer to [[http://lua-users.org/wiki/PatternsTutorial|Pattern Tutorial]].

**Check for numerical values included in a comment**

Example
<code lua>
message = "abc123df432"

-- Assign the portion that matches with 1 to the one
one = string.match(message, "1")
print(one)

-- Assign the portion that matches with 5 in the five
five = string.match(message, "5")
print(five)

-- Assign the portion that matches with %d (a digit of number) to the number
number = string.match(message, "%d")
print(number)

-- Assign the portion that matches with %d+ (a series of number) to the number
number = string.match(message, "%d+")
print(number)
</code>

The result
<code>
1
nil
1
123
</code>

''string.match()'' returns the portion of the specified string that matches with the pattern.\\
In the example, the match() searches a portion of the ''message'' that matches with "1".\\
Then, it searches for "5", but as it doesn't exist, "nil" is returned.

In Lua patterns, ''%d'' represents **any number.**\\
Therefore, it searches for "%d" (a digit of numerical character), then return the first match "1".\\
''%d+'' represents **the longest series of numbers**.\\
Therefore, it returns the longest series of numbers "123".

Lua patterns are not limited to digits or + signs, refer to [[http://lua-users.org/wiki/PatternsTutorial|Pattern Tutorial]] for more Lua patterns.