WoW:API strsplit: Difference between revisions
No edit summary |
m (Move page script moved page API strsplit to API strsplit without leaving a redirect) |
||
| (3 intermediate revisions by 3 users not shown) | |||
| Line 8: | Line 8: | ||
== Arguments == | == Arguments == | ||
;delimiter : String - Characters (bytes) that will be interpreted as delimiter characters (bytes) in the string. | |||
;subject : String - String to split. | |||
;pieces : Number (optional) - Maximum number of pieces to make (the "last" piece would contain the rest of the string); by default, an unbounded number of pieces is returned. | |||
== Returns == | == Returns == | ||
<!-- List each return value, together with its type --> | <!-- List each return value, together with its type --> | ||
A list of strings. Not a table. | A list of strings. Not a table. If the delimiter is not found in the subject string, the whole subject string will be returned. | ||
== Example == | == Example == | ||
| Line 41: | Line 37: | ||
tinsert(tbl, v) | tinsert(tbl, v) | ||
end | end | ||
Additionally note that the delimiter defines all bytes that will split the string, e.g.: | |||
strsplit("ab", "1a2b3") -- => "1", "2", "3" | |||
or | |||
strsplit("ab", "1ab2") -- => "1", "", "2" | |||
Nota Bene: This function does not handle embedded NUL characters ("\0") gracefully. If you need a unique "signpost" character embedded in your strings to be split apart later, try the ASCII bell character ("\a"). This won't show up in the game, and strsplit handles it just fine. | Nota Bene: This function does not handle embedded NUL characters ("\0") gracefully. If you need a unique "signpost" character embedded in your strings to be split apart later, try the ASCII bell character ("\a"). This won't show up in the game, and strsplit handles it just fine. | ||
Latest revision as of 04:47, 15 August 2023
Splits a string using a delimiter (optionally: into a specified number of pieces)
s1, s2, s3 ... sn = strsplit("delimiter", "subject"[, pieces])
Arguments[edit]
- delimiter
- String - Characters (bytes) that will be interpreted as delimiter characters (bytes) in the string.
- subject
- String - String to split.
- pieces
- Number (optional) - Maximum number of pieces to make (the "last" piece would contain the rest of the string); by default, an unbounded number of pieces is returned.
Returns[edit]
A list of strings. Not a table. If the delimiter is not found in the subject string, the whole subject string will be returned.
Example[edit]
local a, b, c = strsplit(" ", "a b c d", 3)
Result
a = "a" b = "b" c = "c d"
Details[edit]
Again, note that the return from strsplit is a list of values, not a table. To get a table, use e.g.:
local tbl = { strsplit(delimiter, subject) }
Also note that strsplit uses a raw string as delimited, not a pattern, so it's not particularily well-suited for e.g. commandline arguments, where it should be ok to use multiple spaces. To extract whitespace-separated arguments, you can use e.g.
local tbl = {}
for v in string.gmatch(" this has lots of space ", "[^ ]+") do
tinsert(tbl, v)
end
Additionally note that the delimiter defines all bytes that will split the string, e.g.:
strsplit("ab", "1a2b3") -- => "1", "2", "3"
or
strsplit("ab", "1ab2") -- => "1", "", "2"
Nota Bene: This function does not handle embedded NUL characters ("\0") gracefully. If you need a unique "signpost" character embedded in your strings to be split apart later, try the ASCII bell character ("\a"). This won't show up in the game, and strsplit handles it just fine.