Create a new splitter for a given list of substrings.

Substrings are matched for in the order the appear in the list, if one substring is the substring of another place it later in the list than the superstring.

Empty strings are discarded, and an empty list will not split off any prefix.

There is a small cost to creating a splitter, so if you are going to split a string multiple times, and you want as much performance as possible, then it is better to reuse the same splitter than to create a new one each time.

Use the splitter to find the first substring in the input string, splitting the input string at that point.

A tuple of three strings is returned:

1. The string prefix before the split.
2. The substring the string was split with.
3. The string suffix after the split.

If no substring was found then strings 2 and 3 will be empty, and string 1 will be the whole input string.

Examples

let line_ends = splitter.new(["\n", "\r\n"])

splitter.split(line_ends, "1. Bread\n2. Milk\n")
// -> #("1. Bread", "\n", "2. Milk")

splitter.split(line_ends, "No end of line here!")
// -> #("No end of line here!", "", "")