Section Tables

Tables utility functions.

Summary

Return typeFunction and summary
 ArrayClear(table t)
Optimization of clearing a table.
boolArrayContains(table tab, term)
Does tab contains term?
boolisTable(obj)
Returns true if obj is a table or a MyrScript object represented as a table such as Score or Target.
stringstring_join(table list, string delimiter)
Concat the elements of table list, separated by the string delimiter.
tablestring_split(string s, string delim)
Split the string s by a string delimiter delim.
tablestring_split_lines(string s)
Split the string s by lines, handle \r, \n and \r\n.
 tdebug(tab)
Return the structure of a table, Collection or Map for debugging to the console.

Functions

isTable(obj)

Returns true if obj is a table or a MyrScript object represented as a table such as Score or Target.

ParameterTypeDefaultDescription
obj   
Return
bool:

tdebug(tab)

Return the structure of a table, Collection or Map for debugging to the console.

ParameterTypeDefaultDescription
tab   

ArrayClear(table t)

Optimization of clearing a table.

tremove is time consuming because it shift all items after the removed one.
tremove from last to first would be a bit faster.
but setting items to nil is even faster.

ParameterTypeDefaultDescription
ttable The table to clear.

ArrayContains(table tab, term)

Does tab contains term?

ParameterTypeDefaultDescription
tabtable A table of numbers or strings
term  A number or a string to find in tab
Return
bool: true, or ni (for false)
Error
if tab's items are not comparable with term

string_split(string s, string delim)

Split the string s by a string delimiter delim.

ParameterTypeDefaultDescription
sstring The string to split
delimstring The delimiter
Return
table: An array of at least one item (s if delim is not found)
Example
local t = string_split("Hello World!", " ")
print(t[1]) --> Hello
print(t[2]) --> World!

string_split_lines(string s)

Split the string s by lines, handle \r, \n and \r\n.

ParameterTypeDefaultDescription
sstring The string to split
Return
table: A table of at least one element (s if line separator is not found)

string_join(table list, string delimiter)

Concat the elements of table list, separated by the string delimiter.

ParameterTypeDefaultDescription
listtable  
delimiterstring  
Return
string:
Example
string_join({"Anna", "Bob", "Charlie", "Dolores"}, ", ")
--> Anna, Bob, Charlie, Dolores