utils.split
Lua function utils.split Summary Split a delimited string into a table Prototype `t = utils.split (s, delim)` Description `The function utils.split is intended to do the reverse of table.concat. That is, it takes a string and generates a table of entries, delimited by single-character delimiters (such as comma or newline). Example:
    test = "the,quick,brown,dog,jumped"
    t = utils.split (test, ",")
    tprint (t)
    print (table.concat (t, ","))
Output:
    1="the"
    2="quick"
    3="brown"
    4="dog"
    5="jumped"
    the,quick,brown,dog,jumped
You pass utils.split 2 or 3 arguments: The string to be split The single-character delimiter (optional) the maximum number of splits to do If the 3rd argument is not supplied, or is zero, then the entire string is split. Otherwise, it will be split the number of times you specify. eg.
    t = utils.split (test, ",", 2)
    tprint (t)
Output:
    1="the"
    2="quick"
    3="brown,dog,jumped"
In this case the remaining text is placed in the 3rd table item.` See Also ... Topics Lua base functions Lua bc (big number) functions Lua bit manipulation functions Lua coroutine functions Lua debug functions Lua io functions Lua math functions Lua os functions Lua package functions Lua PCRE regular expression functions Lua script extensions Lua string functions Lua table functions Lua utilities Scripting Lua functions utils.base64decode (Decode a string which was base-64 encoded) utils.base64encode (Encode a string with base-64 encoding) utils.choose (Display a combo box with choices in it) utils.compress (Compress a string) utils.decompress (Decompress a string) utils.editbox (Display a large message box and get free-format reply) utils.edit_distance (Returns the Levenshtein Edit Distance between two words) utils.filepicker (Invokes the Windows standard "file picker" dialog box) utils.fromhex (Convert a string from hex) utils.functionlist (Returns a table of MUSHclient world function names) utils.hash (Hash a string, returning the hex codes) utils.info (Information about directories) utils.inputbox (Display a message box and get free-format reply) utils.listbox (Display a dialog box with choices in it in a single selection list box) utils.md5 (Hash a string using the 128-bit MD5 algorithm) utils.metaphone (Returns metaphones (sound-alike codes) for the supplied word) utils.msgbox (Display a message box and get a response) utils.multilistbox (Display a dialog box with choices in it in a multiple selection list box) utils.readdir (Read a disk directory into a table) utils.sha256 (Hash a string using a 256-bit hash) utils.spellcheckdialog (Spell-checker dialog) utils.tohex (Convert a string into hex) utils.utf8decode (Encodes a series of Unicode codes into a UTF-8 string) utils.utf8encode (Encodes a series of Unicode codes into a UTF-8 string) utils.utf8valid (Checks if a UTF-8 string is valid) utils.xmlread (Parses an XML string into a nested table) (Help topic: lua=utils.split) Documentation contents page