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

.intersection([arrays])

source,
npm package.

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

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

Версия: 0.1.0

Аргументы

[arrays] (...Array): Массивы для проверки.

Возвращает

(Array): Возвращает новый массив из пересекающихся значений.

Пример

_.intersection([2, 1], [2, 3]);
// => [2]

.intersectionBy([arrays], [iteratee=_.identity])

source,
npm package.

Этот метод подобен _.intersection кроме того, что он принимает iteratee, который вызывается для каждого элемента каждого массива, чтобы создать критерий, по которому они сравниваются.

Порядок и ссылки на результат значений определяет первый массив.

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

Версия: 4.0.0

Аргументы

[arrays] (...Array): Массивы для обработки.
[iteratee=_.identity] (Function): Функция, вызываемая на каждой итерации.

Возвращает

(Array): Возвращает новый массив пересекающихся значений.

Пример

_.intersectionBy([2.1, 1.2], [2.3, 3.4], Math.floor);
// => [2.1]
 
// The `_.property` iteratee shorthand.
_.intersectionBy([{ 'x': 1 }], [{ 'x': 2 }, { 'x': 1 }], 'x');
// => [{ 'x': 1 }]

.intersectionWith([arrays], [comparator])

source,
npm package.

Этот метод подобен _.intersection за исключением того, что он принимает comparator, который вызывается для сравнения элементов массивов.

Порядок и ссылки на результат значений определяет первый массив.

Вызов comparator производится с двумя аргументами: (arrVal, othVal).

Версия: 4.0.0

Аргументы

[arrays] (...Array): Массивы для обработки.
[comparator] (Function): comparator ссылаться на каждый элемент.

Возвращает

(Array): Возвращает новый массив из пересекающихся значений.

Пример

var objects = [{ 'x': 1, 'y': 2 }, { 'x': 2, 'y': 1 }];
var others = [{ 'x': 1, 'y': 1 }, { 'x': 1, 'y': 2 }];
 
_.intersectionWith(objects, others, _.isEqual);
// => [{ 'x': 1, 'y': 2 }]

.join(array, [separator=','])

source,
npm package.

Преобразует все элементы массива в строку, разделенную разделителем.

Версия: 4.0.0

Аргументы

array (Array): Массив для преобразования.
[separator=','] (string): Задаем разделитель.

Возвращает

(string): Возвращает строку объединенных значений.

Пример

_.join(['a', 'b', 'c'], '~');
// => 'a~b~c'

.last(array)

source,
npm package.

Возвращает последний элемент массива.

Версия: 0.1.0

Аргументы

array (Array): Массив для запроса.

Возвращает

(*): Возвращает последний элемент массива.

Пример

_.last([1, 2, 3]);
// => 3

.lastIndexOf(array, value, [fromIndex=array.length-1])

source,
npm package.

Этот метод подобен _.indexOf за исключением того, что он перебирает элементы массива справа налево.

Версия: 0.1.0

Аргументы

array (Array): Массив для проверки.
value (*): Значение для поиска.
[fromIndex=array.length-1] (number): Индекс начальной позиции для поиска.

Возвращает

(number): Возвращает индекс найденного значения, иначе -1.

Пример

_.lastIndexOf([1, 2, 1, 2], 2);
// => 3
 
// Search from the `fromIndex`.
_.lastIndexOf([1, 2, 1, 2], 2, 2);
// => 1

.nth(array, [n=0])

source,
npm package.

Возвращает элемент с индексом n из массива. Если n отрицательное число, то будет возвращен nth элемент с конца.

Версия: 4.11.0

Аргументы

array (Array): Массив для проверки.
[n=0] (number): Индекс возвращенного элемента.

Возвращает

(*): Возвращает nth элемент массива.

Пример

var array = ['a', 'b', 'c', 'd'];
 
_.nth(array, 1);
// => 'b'
 
_.nth(array, -2);
// => 'c';

.pull(array, [values])

source,
npm package.

Удаляет все заданные значения из массива, используя для сравнения равенства метод SameValueZero.

Заметка:

В отличие от .without, этот метод изменяет массив. Используйте .remove для удаления элементов из массива с помощью утверждения.

Версия: 2.0.0

Аргументы

array (Array): Массив для изменения.
[values] (...*): Значение, которое будет удалено удалением.

Возвращает

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

Пример

var array = ['a', 'b', 'c', 'a', 'b', 'c'];
 
_.pull(array, 'a', 'c');
console.log(array);
// => ['b', 'b']

.pullAll(array, values)

source,
npm package.

Этот метод подобен _.pull за исключением того, что он принимает массив значений для удаления.

Заметка:

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

Версия: 4.0.0

Аргументы

array (Array): Массив для изменения.
[values] (...*): Значение, которое будет удалено удалением.

Возвращает

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

Пример

var array = ['a', 'b', 'c', 'a', 'b', 'c'];
 
_.pullAll(array, ['a', 'c']);
console.log(array);
// => ['b', 'b']

.pullAllBy(array, values, [iteratee=_.identity])

source,
npm package.

Этот метод подобен _.pullAll за исключением того, что он принимает iteratee, который вызывается для каждого элемента массива и значений для генерации критерия, с помощью которого они сравниваются.

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

Заметка:

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

Версия: 4.0.0

Аргументы

array (Array): Массив для изменения.
values (Array): Значения, которые будут удалены.
[iteratee=_.identity] (Function): iteratee вызывается для каждого элемента.

Возвращает

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

Пример

var array = [{ 'x': 1 }, { 'x': 2 }, { 'x': 3 }, { 'x': 1 }];
 
_.pullAllBy(array, [{ 'x': 1 }, { 'x': 3 }], 'x');
console.log(array);
// => [{ 'x': 2 }]