Vital.sandbox
String

string.split

Shared

Splits a string into a table of substrings using a separator


Syntax

local parts = string.split(input, separator)

Parameters

TypeNameDescription
stringinputString to be splitted
stringseparatorDelimiter string to split by

Returns

TypeNameDescription
tablepartsArray of split substrings

Examples

Split a string by comma
local parts = string.split("apple,banana,orange", ",")

engine.print("info", parts[1]) --'apple'
engine.print("info", parts[2]) --'banana'
engine.print("info", parts[3]) --'orange'
Split a string by a multi-character delimiter
local parts = string.split("one::two::three", "::")

engine.print("info", parts[1]) --'one'
engine.print("info", parts[2]) --'two'
engine.print("info", parts[3]) --'three'
Split a string by space
local words = string.split("hello world lua", " ")

for i, word in ipairs(words) do
    engine.print("info", word)
end

--[[
Output:
'hello'
'world'
'lua'
]]

On this page