<p>
Splits the provided text into an array with a maximum length, separators
specified.
</p>
<p>
<p>
The separator is not included in the returned string array. Adjacent
separators are treated as one separator.
</p>
<p>
<p>
A <code>null</code> input string returns <code>null</code>. A
<code>null</code> separatorChars splits on whitespace.
</p>
<p>
<p>
If more than <code>max</code> delimited substrings are found, the last
returned string includes all characters after the first
<code>max - 1</code> returned strings (including separator characters).
</p>
<p>
<pre>
StringUtils.split(null, *, *) = null
StringUtils.split("", *, *) = []
StringUtils.split("ab de fg", null, 0) = ["ab", "cd", "ef"]
StringUtils.split("ab de fg", null, 0) = ["ab", "cd", "ef"]
StringUtils.split("ab:cd:ef", ":", 0) = ["ab", "cd", "ef"]
StringUtils.split("ab:cd:ef", ":", 2) = ["ab", "cd:ef"]
</pre>
@param str the string to parse, may be null
@param separatorChars the characters used as the delimiters, <code>null</code>
splits on whitespace
@param max the maximum number of elements to include in the array. A zero
or negative value implies no limit
@return an array of parsed Strings, <code>null</code> if null string
input
<p> Splits the provided text into an array with a maximum length, separators specified. </p> <p> <p> The separator is not included in the returned string array. Adjacent separators are treated as one separator. </p> <p> <p> A <code>null</code> input string returns <code>null</code>. A <code>null</code> separatorChars splits on whitespace. </p> <p> <p> If more than <code>max</code> delimited substrings are found, the last returned string includes all characters after the first <code>max - 1</code> returned strings (including separator characters). </p> <p> <pre> StringUtils.split(null, *, *) = null StringUtils.split("", *, *) = [] StringUtils.split("ab de fg", null, 0) = ["ab", "cd", "ef"] StringUtils.split("ab de fg", null, 0) = ["ab", "cd", "ef"] StringUtils.split("ab:cd:ef", ":", 0) = ["ab", "cd", "ef"] StringUtils.split("ab:cd:ef", ":", 2) = ["ab", "cd:ef"] </pre>
@param str the string to parse, may be null @param separatorChars the characters used as the delimiters, <code>null</code> splits on whitespace @param max the maximum number of elements to include in the array. A zero or negative value implies no limit @return an array of parsed Strings, <code>null</code> if null string input