/ lodash

Lodash документация на русском (массивы) часть 4

“Массивы” - часть 4

.pullAllWith(array, values, [comparator])

source,
npm package.

Этот метод подобен _.pullAll кроме этого он принимает comparator, который вызывается, чтобы сравнить элементы от array до values. Вызов comparator производится с двумя аргументами: (arrVal, othVal).

Заметка:

Unlike _.differenceWith, this method mutates array.

Версия: 4.6.0

Аргументы

array (Array): Массив для обработки.
values (Array): Значения для удаления.
[comparator] (Function): comparator ссылаться на элемент.

Возвращает

(Array): Возвращает массив.

Пример


var array = [{ 'x': 1, 'y': 2 }, { 'x': 3, 'y': 4 }, { 'x': 5, 'y': 6 }];
 
_.pullAllWith(array, [{ 'x': 3, 'y': 4 }], _.isEqual);
console.log(array);
// => [{ 'x': 1, 'y': 2 }, { 'x': 5, 'y': 6 }]

.pullAt(array, [indexes])

source,
npm package.

Удаляет элементы из array, соответствующие по индексам, и возвращает массив из удаленных элементов.

Заметка:

В отличие от _.at, этот метод изменяет массив.

Версия: 3.0.0

Аргументы

array (Array): Массив для изменения.
[indexes] (...(number|number[])): Индексы элементов, которые будут удалять.

Возвращает

(Array): Возвращает новый массив из удаленных элементов.

Пример


var array = ['a', 'b', 'c', 'd'];
var pulled = _.pullAt(array, [1, 3]);
 
console.log(array);
// => ['a', 'c']
 
console.log(pulled);
// => ['b', 'd']

.remove(array, [predicate=_.identity])

source,
npm package.

Удаляет все элементы из массива predicate, который возвращает истину и возвращает массив из удаленных элементов.

predicate вызывается с тремя аргументами: (value, index, array).

Заметка:

В отличие от _.at, этот метод изменяет массив.

Версия: 3.0.0

Аргументы

array (Array): Массив для изменения.
[indexes] (...(number|number[])): Индексы элементов, которые будут удалены.

Возвращает

(Array): Возвращает новый массив из удаленных элементов.

Пример


var array = ['a', 'b', 'c', 'd'];
var pulled = _.pullAt(array, [1, 3]);
 
console.log(array);
// => ['a', 'c']
 
console.log(pulled);
// => ['b', 'd']

.reverse(array)

source,
npm package.

Изменяет массив так, что первый элемент становится последним, второй элемент станет предпоследним и так далее.

Заметка:

Этот метод изменяет массив и основан на
Array#reverse.

Версия: 4.0.0

Аргументы

array (Array): Массив для изменения.

Возвращает

(Array): Возвращает массив.

Пример


var array = [1, 2, 3];
 
_.reverse(array);
// => [3, 2, 1]
 
console.log(array);
// => [3, 2, 1]

.slice(array, [start=0], [end=array.length])

source,
npm package.

Создает срез массива от начала до, но не включая конец.

Заметка:

Этот метод используется вместо Array#slice, чтобы обеспечить плотность возвращаемому массиву.

Версия: 3.0.0

Аргументы

array (Array): Массив для срезки.
[start=0] (number): Стартовая позиция.
[end=array.length] (number): Конечная позиция.

Возвращает

(Array): Возвращает срез массива.

.sortedIndex(array, value)

source,
npm package.

Использует двоичный поиск, чтобы определить самый низкий показатель, в котором значения должны быть вставлены в массив для того, чтобы сохранить свой порядок сортировки.

Версия: 0.1.0

Аргументы

array (Array): Отсортированный массив для проверки.
value (*): Значение для оценки.

Возвращает

(number): Возвращает индекс значения, которое должно быть вставлено в массив.

Пример


_.sortedIndex([30, 50], 40);
// => 1

.sortedIndexBy(array, value, [iteratee=_.identity])

source,
npm package.

В отличие от _.sortedIndex за исключением того, что он принимает iteratee, который вызывается по значению и для каждого элемента массива для вычисления их корректного ранжирования.

iteratee вызывается с одним аргументом: (value).

Версия: 4.0.0

Аргументы

array (Array): Отсортированный массив для проверки.
value (*): Значение для оценки.
[iteratee=_.identity] (Function): iteratee ссылаться на элемент.

Возвращает

(number): Возвращает индекс, на какое значение должен быть вставлен в массив.

Пример


var objects = [{ 'x': 4 }, { 'x': 5 }];
 
_.sortedIndexBy(objects, { 'x': 4 }, function(o) { return o.x; });
// => 0
 
// The `_.property` iteratee shorthand.
_.sortedIndexBy(objects, { 'x': 4 }, 'x');
// => 0