Split: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server client function}}
{{Server client function}}
This function splits a string into sub-strings. You specify a character that will act as a separating character; this will determine where to split the sub-strings. For example, it can split the string "Hello World" into two strings containing the two words, by spliting using a space as a seperating character.
This function splits a string into substrings. You specify a character that will act as a separating character; this will determine where to split the sub-strings. For example, it can split the string "Hello World" into two strings containing the two words, by spliting using a space as a separator.


'''Note:''' You can use the function [[gettok]] to retrieve a single token from the string at a specific index. This may be faster for one-off lookups, but considerably slower if you are going to check each token in a long string.
'''Note:''' You can use the function [[gettok]] to retrieve a single token from the string at a specific index. This may be faster for one-off lookups, but considerably slower if you are going to check each token in a long string.
Line 13: Line 13:


===Returns===
===Returns===
Returns a table of the sub-strings.
Returns a table of the substrings.


==Example==
==Example==

Revision as of 19:05, 21 August 2007

This function splits a string into substrings. You specify a character that will act as a separating character; this will determine where to split the sub-strings. For example, it can split the string "Hello World" into two strings containing the two words, by spliting using a space as a separator.

Note: You can use the function gettok to retrieve a single token from the string at a specific index. This may be faster for one-off lookups, but considerably slower if you are going to check each token in a long string.

Syntax

table split ( string stringToSplit, int separatingChar )

Required Arguments

  • stringToSplit The string you wish to split into parts.
  • separatingChar The character you want to use to split (ASCII number)

Returns

Returns a table of the substrings.

Example

This examples takes any console text input and splits it into parts. 

function onConsole ( text )
    -- Grab the table of tokens
    splittext = split ( text, 32 )
    -- for each token there...
    for splitKey, splitVal in ipairs(splittext) do
        -- output the index and token
        outputChatBox ( splitKey .. ": " .. splitVal )
    end
end
addEventHandler ( "onConsole", getRootElement ( ), onConsole )

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/Split?oldid=10856"