CoreString

The CoreString namespace contains a set of string utility functions.

Class Functions

Class Function Name	Return Type	Description	Tags
`CoreString.Join(string delimiter, [...])`	`string`	Concatenates the given values together, separated by `delimiter`. If a given value is not a string, it is converted to one using `tostring()`.	None
`CoreString.Split(string s, [string delimiter], [table parameters])`	`...`	Splits the string `s` into substrings separated by `delimiter`. Optional parameters in the `parameters` table include: `removeEmptyResults (boolean)`: If `true`, empty strings will be removed from the results. Defaults to `false`. `maxResults (integer)`: Limits the number of strings that will be returned. The last result will be any remaining unsplit portion of `s`. `delimiters (string or Array<string>)`:Allows splitting on multiple delimiters. If both this and the `delimiter` parameter are specified, the combined list is used. If neither is specified, default is to split on any whitespace characters. Note that this function does not return a table, it returns multiple strings. For example: `local myHello, myCore = CoreString.Split("Hello Core!")` If a table is desired, wrap the call to `Split()` in curly braces, eg: `local myTable = {CoreString.Split("Hello Core!")}`	None
`CoreString.Trim(string s, [...])`	`string`	Trims whitespace from the start and end of `s`, returning the result. An optional list of strings may be provided to trim those strings from `s` instead of the default whitespace. For example, `CoreString.Trim("(==((Hello!))==)", "(==(", ")==)")` returns "(Hello!)".	None

Examples

Example using:

`Split`

`Join`

In this example, the words in a sentence are sorted into alphabetical order.

local text = "the quick brown fox jumps over the lazy dog."
-- Split into a table
local words = {
    CoreString.Split(text, {
        delimiters = {" ", "."}, 
        removeEmptyResults = true
    })
}
-- Sort the table
table.sort(words)
-- Join from a table
local sortedText = CoreString.Join(" ", table.unpack(words))
-- Output to Event Log
print(text)
print(sortedText)

`Trim`

In this example we look at different ways to use the Trim() function to eliminate symbols from the beginning and end of a string. Results are printed to the Event Log.

local original = "  Hello World!!!"
local trimmed1 = CoreString.Trim(original)
local trimmed2 = CoreString.Trim(original, "!", " ")

print(original)
print(trimmed1)
print(trimmed2)