Module: utils/src/modules/__indexArrays ​

Functions ​

chunk ​

▸ chunk<V>(array, size?): TypeOfList<V>[][]

返回一个数组，数组由给定数组拆分成多个size长度的区块组成。 如果给定数组无法被分割成全部等长的区块，那么最后剩余的元素将组成一个区块。

Example

chunk([1, 2, 3, 4, 5], 2)
=> [[1, 2], [3, 4], [5]]

chunk([1, 2, 3, 4, 5], 2)
=> [[1, 2], [3, 4], [5]]

Type parameters ​

Parameters ​

Returns ​

TypeOfList<V>[][]

compact ​

▸ compact<V>(array): Truthy<TypeOfList<V>>

返回一个数组，数组由给定数组中所有的非假值元素组成。例如false，null，0，""，undefined和NaN都被认为是“假值”。

Example

compact([0, 1, false, 2, '', 3])
=> [1, 2, 3]

compact([0, 1, false, 2, '', 3])
=> [1, 2, 3]

Type parameters ​

Parameters ​

Returns ​

Truthy<TypeOfList<V>>

difference ​

▸ difference<V>(array, ...values): TypeOfCollection<V, never>[]

返回一个数组，数组由给定数组与values进行差集运算后组成（使用===表达式做相等测试）。

Example

difference([1, 2, 1, 0, 3, 1, 4], 0, 1)
=> [2, 3, 4]

difference([1, 2, 3, 4, 5], [2, 3], [4])
=> [1, 5]

difference([1, 2, 1, 0, 3, 1, 4], 0, 1)
=> [2, 3, 4]

difference([1, 2, 3, 4, 5], [2, 3], [4])
=> [1, 5]

Type parameters ​

Parameters ​

Returns ​

TypeOfCollection<V, never>[]

findIndex ​

▸ findIndex<V>(array, predicate?, context?): number

返回给定数组中第一个通过predicate真值检测的索引，如果没有元素通过检测则返回-1

Example

findIndex([4, 6, 7, 12], (item) => item === 7)
=> 1

findIndex([4, 6, 8, 12], (item) => item === 1)
=> -1

findIndex([4, 6, 7, 12], (item) => item === 7)
=> 1

findIndex([4, 6, 8, 12], (item) => item === 1)
=> -1

Type parameters ​

Parameters ​

Returns ​

number

findLastIndex ​

▸ findLastIndex<V>(array, predicate?, context?): number

反向迭代数组，返回给定数组中第一个通过predicate真值检测的索引，如果没有元素通过检测则返回-1

Example

findLastIndex([4, 6, 7, 12], (item) => item === 7)
=> 2

findLastIndex([4, 6, 8, 12], (item) => item === 1)
=> -1

findLastIndex([4, 6, 7, 12], (item) => item === 7)
=> 2

findLastIndex([4, 6, 8, 12], (item) => item === 1)
=> -1

Type parameters ​

Parameters ​

Returns ​

number

flatten ​

▸ flatten<V>(array, depth?): DeepestListItemOrSelf<TypeOfList<V>>[]

推荐原生：Array.prototype.flat。 返回一个数组，数组由给定数组扁平化后组成，传递depth控制递归深度。

Example

flatten([1, [2], [3, [[4]]]])
=> [1, 2, 3, 4]

flatten([1, [2], [3, [[4]]]], 1)
=> [1, 2, 3, [[4]]]

flatten([1, [2], [3, [[4]]]])
=> [1, 2, 3, 4]

flatten([1, [2], [3, [[4]]]], 1)
=> [1, 2, 3, [[4]]]

Type parameters ​

Parameters ​

Returns ​

DeepestListItemOrSelf<TypeOfList<V>>[]

head ​

▸ head<V>(array): undefined | TypeOfList<V>

返回给定数组的第一个元素，无数据返回undefined。

Example

head([1, 2, 3])
=> 1

head([1, 2, 3])
=> 1

Type parameters ​

Parameters ​

Returns ​

undefined | TypeOfList<V>

indexOf ​

▸ indexOf<V>(array, value?, isSortedOrFromIndex?): number

推荐原生：Array.prototype.indexOf。 返回value在给定数组中的索引，如果value不存在则返回-1，若数组已升序则推荐isSortedOrFromIndex参数传递true使用二分查找。

Example

indexOf([1, 2, 3], 2)
=> 1

indexOf([1, 2, 3], 4)
=> -1

indexOf([1, 2, 3], 2)
=> 1

indexOf([1, 2, 3], 4)
=> -1

Type parameters ​

Parameters ​

Returns ​

number

initial ​

▸ initial<V>(array): never[] | TypeOfList<V>

返回一个数组，数组由给定数组中除了最后一个元素之外的所有元素（去除给定数组中的最后一个元素）组成。

Example

initial([1, 2, 3])
=> [1, 2]

initial([1, 2, 3])
=> [1, 2]

Type parameters ​

Parameters ​

Returns ​

never[] | TypeOfList<V>

intersection ​

▸ intersection<V>(...arrays): V[]

返回一个数组，数组由给定数组集合的交集组成。

Example

intersection([1, 2, 3], [101, 2, 1, 10], [2, 1])
=> [1, 2]

intersection([1, 2, 3])
=> [1, 2, 3]

intersection([1, 2, 3], [101, 2, 1, 10], [2, 1])
=> [1, 2]

intersection([1, 2, 3])
=> [1, 2, 3]

Type parameters ​

Parameters ​

Returns ​

V[]

last ​

▸ last<V>(array): undefined | TypeOfList<V>[]

返回给定数组的最后一个元素，无数据返回undefined。

Example

last([1, 2, 3])
=> 3

last([1, 2, 3])
=> 3

Type parameters ​

Parameters ​

Returns ​

undefined | TypeOfList<V>[]

lastIndexOf ​

▸ lastIndexOf<V>(array, value?, isSortedOrFromIndex?): number

推荐原生：Array.prototype.lastIndexOf。 反向迭代数组，返回value在给定数组中的索引，如果value不存在则返回-1，若数组已升序则推荐isSortedOrFromIndex参数传递true使用二分查找。

Example

lastIndexOf([1, 2, 3, 1, 2, 3], 2)
=> 4

lastIndexOf([1, 2, 3, 1, 2, 3], 5)
=> -1

lastIndexOf([1, 2, 3, 1, 2, 3], 2)
=> 4

lastIndexOf([1, 2, 3, 1, 2, 3], 5)
=> -1

Type parameters ​

Parameters ​

Returns ​

number

object ​

▸ object<V>(array): Dictionary<PairValue<TypeOfList<V>>>

推荐原生：Object.fromEntries。 返回一个对象，对象由给定键-值对数组转换后组成。entries的反函数。如果存在重复键，最后一个值将被返回。

Example

object([['moe', 30], ['larry', 40], ['curly', 50]])
=> {moe: 30, larry: 40, curly: 50}

object([['moe', 30], ['larry', 40], ['curly', 50]])
=> {moe: 30, larry: 40, curly: 50}

Type parameters ​

Parameters ​

Returns ​

Dictionary<PairValue<TypeOfList<V>>>

range ​

▸ range(start, stop?, step?): number[]

返回一个数组，数组由start到stop之间的整数组成，如果没有传递stop，则start作为结束值，0为起始。 用step来增加（或减少）步长，便于forEach和map循环。 如果需要一个负数的值域 ，请使用负数step。

Example

range(10)
=> [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]

range(1, 11)
=> [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]

range(0, 30, 5)
=> [0, 5, 10, 15, 20, 25]

range(0, -10, -1)
=> [0, -1, -2, -3, -4, -5, -6, -7, -8, -9]

range(0)
=> []

range(10)
=> [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]

range(1, 11)
=> [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]

range(0, 30, 5)
=> [0, 5, 10, 15, 20, 25]

range(0, -10, -1)
=> [0, -1, -2, -3, -4, -5, -6, -7, -8, -9]

range(0)
=> []

Parameters ​

Returns ​

number[]

sortedIndex ​

▸ sortedIndex<V>(array, value, iteratee?, context?): number

使用二分查找返回value在给定数组（数组已升序）对应处的索引，常用在需要确定value在给定数组中的位置序号，value按此序号插入能保持给定数组原有的排序。

Example

sortedIndex([10, 20, 30, 40, 50], 35)
=> 3

const stooges = [{name: 'moe', age: 40}, {name: 'curly', age: 60}]
sortedIndex(stooges, {name: 'larry', age: 50}, 'age')
=> 1

sortedIndex([10, 20, 30, 40, 50], 35)
=> 3

const stooges = [{name: 'moe', age: 40}, {name: 'curly', age: 60}]
sortedIndex(stooges, {name: 'larry', age: 50}, 'age')
=> 1

Type parameters ​

Parameters ​

Returns ​

number

tail ​

▸ tail<V>(array): TypeOfList<V>[]

返回一个数组，数组由给定数组中除了第一个元素外之外的所有元素（去除给定数组中的第一个元素）组成。

Example

tail([1, 2, 3])
=> [2, 3]

tail([1, 2, 3])
=> [2, 3]

Type parameters ​

Parameters ​

Returns ​

TypeOfList<V>[]

union ​

▸ union<V>(...arrays): List<V>[]

返回一个数组，数组由给定数组集合的并集组成，uniq的简化版本且接收参数为数组的集合。 当处理数据量小（length < 100,000）时，推荐使用Array.from(new Set(array))。

Example

union([1, 2, 3], [101, 2, 1, 10], [2, 1])
=> [1, 2, 3, 101, 10]

union([1, 2, 3], [101, 2, 1, 10], [2, 1])
=> [1, 2, 3, 101, 10]

Type parameters ​

Parameters ​

Returns ​

List<V>[]

uniq ​

▸ uniq<V, I>(array, isSorted?, iteratee?, context?): TypeOfList<V>[]

返回一个数组，数组由给定数组的并集组成，使用===做相等测试。 如果要处理对象元素, 需要传递iteratee函数来获取要对比的属性。

Example

uniq([1, 2, 1, 4, 1, 3])
=> [1, 2, 4, 3]

uniq([1, 2, 1, 4, 1, 3])
=> [1, 2, 4, 3]

Type parameters ​

Parameters ​

Returns ​

TypeOfList<V>[]

unzip ​

▸ unzip<V>(arrays): PropertyTypeOrAny<TypeOfCollection<V, never>, number>[][]

返回一个数组，数组由给定数组按索引分组组成。zip的反函数。

Example

unzip([['moe', 30, true], ['larry', 40, false], ['curly', 50, false]])
=> [['moe', 'larry', 'curly'], [30, 40, 50], [true, false, false]]

unzip([['moe', 30, true], ['larry', 40, false], ['curly', 50, false]])
=> [['moe', 'larry', 'curly'], [30, 40, 50], [true, false, false]]

Type parameters ​

Parameters ​

Returns ​

PropertyTypeOrAny<TypeOfCollection<V, never>, number>[][]

zip ​

▸ zip<V>(...arrays): PropertyTypeOrAny<V, number>[][]

返回一个数组，数组由给定数组集合按索引分组汇总组成。

Example

zip(['moe', 'larry', 'curly'], [30, 40, 50], [true, false, false])
=> [['moe', 30, true], ['larry', 40, false], ['curly', 50, false]]

zip(['moe', 'larry', 'curly'], [30, 40, 50], [true, false, false])
=> [['moe', 30, true], ['larry', 40, false], ['curly', 50, false]]

Type parameters ​

Parameters ​

Returns ​

PropertyTypeOrAny<V, number>[][]