====== Array ======

Встроенный класс JavaScript для работы с массивами. Массив может быть определён одним из способов:

  * ''[]''
  * ''new Array()''
  * ''new Array(length)''

class:: Array(args, …)

Создаёт новый массив. Передайте один целочисленный аргумент (≥ 0) в качестве длины массива или же сами элементы массива.

func:: Array.isArray(var)

prop:: length
Возвращаем количество элементов в массиве.
<code javascript>
// Создаем массив
var x = [23, true, 'text1', -34.4, undefined, { prop1: 34, prop2: true}, 'text2'];

// Найдем количество элементов в массиве
var l = x.length;

// Отобразим в консоле
print(l); // Отобразиться число 7
</code>

meth:: concat(args, …)

Создаёт новый массив, который состоит из элементов текущего и элементов, переданных в качестве аргументов. Если какой-либо аргумент сам является массивом, будут добавлены все его элементы.

<code javascript>
// Создаем два массива
var arr1 = [23, true, 'text1', -34.4, undefined];
var arr2 = [{ prop1: 34, prop2: true}, 'text2'];

// Получим новый массив, состоящий из элементов
// массива arr1, элемента 255, элемента true и элементов массива arr2
var resArray = arr1.concat(255, true, arr2);

// Отобразим в консоле
print(resArray);

/*
 * Результат вывода:
 * [ 23, true, "text1", -34.4, undefined, 255, true, { "prop1": 34, "prop2": true }, "text2" ]
 */
</code>
meth:: Метод Array.every(func, thisArg)

Возвращает ''true'' если функция ''func'' возвращает ''true'' для каждого элемента массива.

meth:: fill(value [, start [, end]])
Заполняет элементы массива значением ''value'', с позиции ''start'' до позиции ''end''. Если параметра ''start'' не передан — заполняются все элементы массива. Если параметр ''end'' не передан — массив будет заполнен до последнего элемента. Обратите внимание, что ''end'' — номер элемента, до которого будет выполнятся заполнение.

<code javascript>
// Создаем массив размерностью в 10-ть элементов
// После создания, каждый элемент равен undefined - не определен
var x = new Array(10);

// Заполним массив числом 255 с элемента 5 до элемента 7
x.fill(255, 5, 7);

// Отобразим в консоле
print(x);

/*
 * Результат отображения:
 * [ undefined, undefined, undefined, undefined, undefined, 255, 255, undefined, undefined, undefined ]
 */
</code>
meth:: Array.filter(function, thisArg)
meth:: forEach(callback, thisArg)
Вызывает функцию ''callback'' для каждого элемента массива, передавая в качестве параметров:
  * ''value'' — значение текущего элемента;
  * ''i'' — положение элемента в массиве;
  * ''array'' — перебираемый массив.


<code javascript>
var x = [34, 456, "text", true];
x.forEach(function(val, i, arr){
  print('x[' + i+ '] = ', val);
});

/*
 * Результат вывода:
 * x[0] =  34
 * x[1] =  456
 * x[2] =  text
 * x[3] =  true
 */
</code>
meth:: Array.indexOf(value)

meth:: Array.join(separator)

meth:: Array.map(function, thisArg)
meth:: Array.pop()
meth:: push(arguments, ...)
Метод добавляет в конец массива элементы, переданные в качестве параметров.

<code javasript>
// Создаем два массива
var arr = [23, true, 'text1'];

// Добавим пару элементов
arr.push('newElem1');
arr.push('newElem2');

// Отобразим в консоле
print(arr);

/*
 * Результат вывода:
 * [ 23, true, "text1", "newElem1", "newElem2" ]
 */
</code>
meth:: Array.reduce(callback, initialValue)
meth:: Array.reverse()
meth:: Array.shift()
meth:: Array.slice(start, end)
meth:: Array.some(function, thisArg)
meth:: Array.sort(var)
meth:: Array.splice(index, howMany, elements, ...)
meth:: Array.toString(radix)
meth:: Array.unshift(elements, ...)