split method

List<String> split (Pattern pattern)

Splits the string at matches of pattern and returns a list of substrings.

Finds all the matches of pattern in this string, and returns the list of the substrings between the matches.

var string = "Hello world!";
string.split(" ");                      // ['Hello', 'world!'];

Empty matches at the beginning and end of the strings are ignored, and so are empty matches right after another match.

var string = "abba";
string.split(new RegExp(r"b*"));        // ['a', 'a']
                                        // not ['', 'a', 'a', '']

If this string is empty, the result is an empty list if pattern matches the empty string, and it is [""] if the pattern doesn't match.

var string = '';
string.split('');                       // []
string.split("a");                      // ['']

Splitting with an empty pattern splits the string into single-code unit strings.

var string = 'Pub';
string.split('');                       // ['P', 'u', 'b']

string.codeUnits.map((unit) {
  return new String.fromCharCode(unit);
}).toList();                            // ['P', 'u', 'b']

Splitting happens at UTF-16 code unit boundaries, and not at rune boundaries:

// String made up of two code units, but one rune.
string = '\u{1D11E}';
string.split('').length;                 // 2 surrogate values

To get a list of strings containing the individual runes of a string, you should not use split. You can instead map each rune to a string as follows:

string.runes.map((rune) => new String.fromCharCode(rune)).toList();

Implementation

List<String> split(Pattern pattern);