Skip to content

split (Lodash 兼容性)

请使用 JavaScript 的 String.prototype.split

split 函数由于处理 nullundefined 而运行缓慢。

请使用更快、更现代的 JavaScript 的 String.prototype.split

使用分隔符将字符串拆分为数组。

typescript
const segments = split(str, separator);

参考

split(string, separator?, limit?)

当您想使用特定分隔符将字符串拆分为数组时,请使用 split。您还可以限制结果数组的最大长度。

typescript
import { split } from 'es-toolkit/compat';

// 按连字符拆分
split('a-b-c', '-');
// 返回值: ['a', 'b', 'c']

// 限制结果数量
split('a-b-c-d', '-', 2);
// 返回值: ['a', 'b']

// 按正则表达式拆分
split('hello world', /\s/);
// 返回值: ['hello', 'world']

如果未指定分隔符,整个字符串将成为数组的第一个元素。

typescript
import { split } from 'es-toolkit/compat';

split('hello');
// 返回值: ['hello']

nullundefined 被视为空字符串。

typescript
import { split } from 'es-toolkit/compat';

split(null);
// 返回值: ['']

split(undefined);
// 返回值: ['']

参数

  • string (string, 可选): 要拆分的字符串。默认为空字符串。
  • separator (RegExp | string, 可选): 用于拆分的分隔符。
  • limit (number, 可选): 结果数组的最大长度。

返回值

(string[]): 返回由分隔符拆分的字符串数组。

采用 MIT 许可证发布。