|
|
|
var isRegExp = require('./isRegExp'),
|
|
|
|
stringToArray = require('./_stringToArray'),
|
|
|
|
toString = require('./toString');
|
|
|
|
|
|
|
|
/** Used to compose unicode character classes. */
|
|
|
|
var rsAstralRange = '\\ud800-\\udfff',
|
|
|
|
rsComboMarksRange = '\\u0300-\\u036f\\ufe20-\\ufe23',
|
|
|
|
rsComboSymbolsRange = '\\u20d0-\\u20f0',
|
|
|
|
rsVarRange = '\\ufe0e\\ufe0f';
|
|
|
|
|
|
|
|
/** Used to compose unicode capture groups. */
|
|
|
|
var rsZWJ = '\\u200d';
|
|
|
|
|
|
|
|
/** Used to detect strings with [zero-width joiners or code points from the astral planes](http://eev.ee/blog/2015/09/12/dark-corners-of-unicode/). */
|
|
|
|
var reHasComplexSymbol = RegExp('[' + rsZWJ + rsAstralRange + rsComboMarksRange + rsComboSymbolsRange + rsVarRange + ']');
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Splits `string` by `separator`.
|
|
|
|
*
|
|
|
|
* **Note:** This method is based on
|
|
|
|
* [`String#split`](https://mdn.io/String/split).
|
|
|
|
*
|
|
|
|
* @static
|
|
|
|
* @memberOf _
|
|
|
|
* @since 4.0.0
|
|
|
|
* @category String
|
|
|
|
* @param {string} [string=''] The string to split.
|
|
|
|
* @param {RegExp|string} separator The separator pattern to split by.
|
|
|
|
* @param {number} [limit] The length to truncate results to.
|
|
|
|
* @returns {Array} Returns the new array of string segments.
|
|
|
|
* @example
|
|
|
|
*
|
|
|
|
* _.split('a-b-c', '-', 2);
|
|
|
|
* // => ['a', 'b']
|
|
|
|
*/
|
|
|
|
function split(string, separator, limit) {
|
|
|
|
string = toString(string);
|
|
|
|
if (string && (
|
|
|
|
typeof separator == 'string' ||
|
|
|
|
(separator != null && !isRegExp(separator))
|
|
|
|
)) {
|
|
|
|
separator += '';
|
|
|
|
if (separator == '' && reHasComplexSymbol.test(string)) {
|
|
|
|
var strSymbols = stringToArray(string);
|
|
|
|
return limit === undefined ? strSymbols : strSymbols.slice(0, limit < 0 ? 0 : limit);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return string.split(separator, limit);
|
|
|
|
}
|
|
|
|
|
|
|
|
module.exports = split;
|