Native: Array

Набор Array методов.

Смотрите также:

Array Метод: each

Вызывает функцию перебора элементов в массиве.

Синтаксис:

myArray.each(fn[, bind]);

Аргументы:

  1. fn - (function) Функция, которая выполняется при получении элемента массива. Эта функция проходит элемент и он является индексом массива.
  2. bind - (object, опционально) Объект будет использован в функции как 'this'. Дополнительная информация Функция: bind.

Аргумент: fn

Синтаксис:
fn(item, index, array)
Аргументы:
  1. item - (mixed) Текущий элемент массива.
  2. index - (number) Текущий индекс элемента в массиве.
  3. array - (array) Текущий массив.

Примеры:

//Выведет "0 = apple", "1 = banana", и т.д.:
['apple', 'banana', 'lemon'].each(function(item, index){

    alert(index + " = " + item);
}); //Второй опциональный аргумент связывания здесь не используется.

Смотрите также:

Заметки:

  • Этот метод доступен только для браузеров без поддержки собственных MDC Array:forEach.

Array Метод: every

Возвращает true если каждый элемент массива соответствует условиям функции. Этот метод доступен только для браузеров без поддержки собственных Array:every.

Синтаксис:

var allPassed = myArray.every(fn[, bind]);

Аргументы:

  1. fn - (function) Функция проверяет каждый элемент массива.
  2. bind - (object, опционально) Объект будет использован в функции как 'this'. Дополнительная информация Функция: bind.

Аргумент: fn

Синтаксис:
fn(item, index, array)
Аргументы:
  1. item - (mixed) Текущий элемент массива.
  2. index - (number) Текущий индекс элемента в массиве.
  3. array - (array) Текущий массив.

Возвращает:

  • (boolean) Возвращает true если каждый элемент массива соответствует условиям функции. В противном случае возвращает false.

Примеры:

var areAllBigEnough = [10, 4, 25, 100].every(function(item, index){

    return item > 20;
}); //areAllBigEnough = false

Смотрите также:

Array Метод: filter

Создает новый массив со всеми элементами массива, в случае если элемент предусматривает фильтрацию, функция вернет true. Этот метод доступен только для браузеров без поддержки собственных Array: filter.

Синтаксис:

var filteredArray = myArray.filter(fn[, bind]);

Аргументы:

  1. fn - (function) Функция проверяет каждый элемент массива. Эта функция проходит каждый элемент и этот элемент является индексом массива.
  2. bind - (object, опционально) Объект будет использован в функции как 'this'. Дополнительная информация Функция: bind.

Аргумент: fn

Синтаксис:
fn(item, index, array)
Аргументы:
  1. item - (mixed) Текущий элемент массива.
  2. index - (number) Текущий индекс элемента в массиве.
  3. array - (array) Текущий массив.

Возвращает:

  • (array) Новый отфильтрованный массив.

Примеры:

var biggerThanTwenty = [10, 3, 25, 100].filter(function(item, index){

    return item > 20;
}); //biggerThanTwenty = [25, 100]

Смотрите также:

Array Метод: clean

Создает новый массив со всеми элементами родительского массива которые были определены (т.е. не null или undefined).

Синтаксис:

var cleanedArray = myArray.clean();

Возвращает:

  • (array) Новый отфильтрованный массив.

Примеры:

var myArray = [null, 1, 0, true, false, "foo", undefined, ""];
myArray.clean() // Возвращает [1, 0, true, false, "foo", ""]

Array Метод: indexOf

Возвращает индекс первого элемента массива содержащего заданное значение, или -1 если значение не найдено. Этот метод доступен только для браузеров без поддержки собственных Array: indexOf.

Синтаксис:

var index = myArray.indexOf(item[, from]);

Возвращает:

  • (number) Индекс первого элемента массива содержащего заданное значение, или -1 если значение не найдено..

Аргументы:

  1. item - (object) Искомое в массиве значение.
  2. from - (number, опционально: по умолчанию с 0) Индекс массива с которого начинать поиск.

Примеры:

['apple', 'lemon', 'banana'].indexOf('lemon'); //Возвращает 1

['apple', 'lemon'].indexOf('banana'); //Возвращает -1

Смотрите также:

Array Метод: map

Создает новый массив с результатами применения функции к каждому элементу массива. Этот метод доступен только для браузеров без поддержки собственных Array: map.

Синтаксис:

var mappedArray = myArray.map(fn[, bind]);

Аргументы:

  1. fn - (function) Функция создает элемент нового массива из произведения (умножения) элемента текущего.
  2. bind - (object, опционально) Объект будет использован в функции как 'this'. Дополнительная информация Функция: bind.

Аргумент: fn

Синтаксис:
fn(item, index, array)
Аргументы:
  1. item - (mixed) Текущий элемент массива.
  2. index - (number) Текущий индекс элемента в массиве.
  3. array - (array) Текущий массив.

Возвращает:

  • (array) Обработанный массив.

Примеры:

var timesTwo = [1, 2, 3].map(function(item, index){

    return item * 2;
}); // timesTwo = [2, 4, 6];

Смотрите также:

Array Метод: some

Возвращает true, если хотя бы один элемент массива удовлетворяет условие функции. Этот метод доступен только для браузеров без поддержки собственных Array: some.

Синтаксис:

var somePassed = myArray.some(fn[, bind]);

Возвращает:

  • (boolean) Возвращает true, если хотя бы один элемент массива удовлетворяет условие функции. В противном случае возвращает false.

Аргументы:

  1. fn - (function) Функция проверяет каждый элемент массива. Эта функция проходит каждый элемент и этот элемент является индексом массива.
  2. bind - (object, опционально) Объект будет использован в функции как 'this'. Дополнительная информация Функция: bind.

Аргумент: fn

Синтаксис:
fn(item, index, array)
Аргументы:
  1. item - (mixed) Текущий элемент массива.
  2. index - (number) Текущий индекс элемента в массиве.
  3. array - (array) Текущий массив.

Примеры:

var isAnyBigEnough = [10, 4, 25, 100].some(function(item, index){

    return item > 20;
}); //isAnyBigEnough = true

Смотрите также:

Array Метод: associate

Создает объект ключ-значение из исходного массива представляя значения указанного массива ключами.

Синтаксис:

var associated = myArray.associate(obj);

Аргументы:

  1. obj - (array) Эти значения будут представлены ключами создаваемого массива.

Возвращает:

  • (object) Новый ассоциированный объект.

Примеры:

var animals = ['Cow', 'Pig', 'Dog', 'Cat'];

var sounds = ['Moo', 'Oink', 'Woof', 'Miao'];
sounds.associate(animals);

//Возвращает: {'Cow': 'Moo', 'Pig': 'Oink', 'Dog': 'Woof', 'Cat': 'Miao'}

Принимает объект по ключу / функция пары для определения значений.

Синтаксис:

var result = Array.link(array, object);

Аргументы:

  1. object - (object) Объект содержащий ключ / функция пары должна быть пропущена для дальнейшего использования как шаблона для представления значений с другими ключами.

Возвращает:

  • (object) Новый ассоциированный объект.

Примеры:

var el = document.createElement('div');
var arr2 = [100, 'Hello', {foo: 'bar'}, el, false];
arr2.link({myNumber: Number.type, myElement: Element.type, myObject: Object.type, myString: String.type, myBoolean: $defined});

//Возвращает: {myNumber: 100, myElement: el, myObject: {foo: 'bar'}, myString: 'Hello', myBoolean: false}

Array Метод: contains

Проверяет массив на вхождение элемента.

Синтаксис:

var inArray = myArray.contains(item[, from]);

Аргументы:

  1. item - (object) Искомое в массиве значение.
  2. from - (number, опционально: по умолчанию с 0) Индекс начального элемента.

Возвращает:

  • (boolean) Возвращает true если искомое значение найдено. В противном случае вернет false.

Примеры:

["a","b","c"].contains("a"); //Возвращает: true

["a","b","c"].contains("d"); //Возвращает: false

Смотрите также:

Array Метод: extend

Объединяет массив со всеми элементами другого массива.

Синтаксис:

myArray.extend(array);

Аргументы:

  1. array - (array) Массив элементы которого будут добавлены в текущий массив.

Возвращает:

  • (array) Текущий массив.

Примеры:

var animals = ['Cow', 'Pig', 'Dog'];
animals.extend(['Cat', 'Dog']); //animals = ['Cow', 'Pig', 'Dog', 'Cat', 'Dog'];

Array Метод: getLast

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

Синтаксис:

myArray.getLast();

Возвращает:

  • (mixed) Последний элемент массива.
  • (null) Если массив пустой, возвращает null.

Примеры:

['Cow', 'Pig', 'Dog', 'Cat'].getLast(); //returns 'Cat'

Array Метод: getRandom

Возвращает случайный элемент массива.

Синтаксис:

myArray.getRandom();

Возвращает:

  • (mixed) Случайный элемент массива. Если массив пустой, возвращает null.

Примеры:

['Cow', 'Pig', 'Dog', 'Cat'].getRandom(); //вернет один из элементов

Array Метод: include

Вставляет элемент в массив, если он еще не существует (чувствителен к регистру и типу данных).

Синтаксис:

myArray.include(item);

Аргументы:

  1. item - (object) Элемент добавляемый в массив.

Возвращает:

  • (array) Текущий массив с добавленным элементом.

Примеры:

['Cow', 'Pig', 'Dog'].include('Cat'); //вернет ['Cow', 'Pig', 'Dog', 'Cat']

['Cow', 'Pig', 'Dog'].include('Dog'); //вернет ['Cow', 'Pig', 'Dog']

Array Метод: combine

Объединяет массив со всеми элементами другого массива. Не допускает дублирования элементов и чувствителен к регистру и типу данных.

Синтаксис:

myArray.combine(array);

Аргументы:

  1. array - (array) Массив элементы которого будут добавлены в текущий массив.

Возвращает:

  • (array) Текущий массив получающий новые элементы.

Примеры:

var animals = ['Cow', 'Pig', 'Dog'];
animals.combine(['Cat', 'Dog']); //animals = ['Cow', 'Pig', 'Dog', 'Cat'];

Array Метод: erase

Удаляет все вхождения элемента.

Синтаксис:

myArray.erase(item);

Аргументы:

  1. item - (object) Искомый в массиве элемент.

Возвращает:

  • (array) Текущий массив без искомых элементов.

Примеры:

['Cow', 'Pig', 'Dog', 'Cat', 'Dog'].erase('Dog') //возвращает ['Cow', 'Pig', 'Cat']

['Cow', 'Pig', 'Dog'].erase('Cat') //возвращает ['Cow', 'Pig', 'Dog']

Array Метод: empty

Очищает массив.

Синтаксис:

myArray.empty();

Возвращает:

  • (array) Очищенный массив.

Примеры:

var myArray = ['old', 'data'];
myArray.empty(); //myArray равен []

Array Метод: flatten

Конвертирует многомерный массив в одномерный.

Синтаксис:

myArray.flatten();

Возвращает:

  • (array) Новый одномерный массив.

Примеры:

var myArray = [1,2,3,[4,5, [6,7]], [[[8]]]];

var newArray = myArray.flatten(); //newArray равен [1,2,3,4,5,6,7,8]

Array Метод: hexToRgb

Конвертирует шеснадцатиричное цветовое значение в RGB. Входящий массив должен иметь шеснадцатиричный формат. ['FF','FF','FF']

Синтаксис:

myArray.hexToRgb([array]);

Аргументы:

  1. array - (boolean, опционально) Если указано, вернет массив (например [255, 51, 0]) вместо строки (например "rgb(255,51,0)").

Возвращает:

  • (string) Строка представленная в формате цвета RGB.
  • (array) Если массив определен, взамен вернется обработанный массив.

Примеры:

['11','22','33'].hexToRgb(); //возвращает "rgb(17,34,51)"

['11','22','33'].hexToRgb(true); //возвращает [17, 34, 51]

Смотрите также:

Array Метод: rgbToHex

Конвертирует RGB значение цвета в шеснадцатиричный. Входящий массив должен иметь формат RGB. [255,255,255], или [255,255,255,1]

Синтаксис:

myArray.rgbToHex([array]);

Аргументы:

  1. array - (boolean, опционально) Если указано, вернет массив (например ['ff','33','00']) вместо строки (например "#ff3300").

Возвращает:

  • (string) Строка, представляющая цвет в шестнадцатеричном виде или "прозрачным", если четвертое значение rgba в массив равно 0.
  • (array) Если массив определен, взамен вернется обработанный массив.

Примеры:

[17,34,51].rgbToHex(); //возвращает "#112233"

[17,34,51].rgbToHex(true); //возвращает ['11','22','33']
[17,34,51,0].rgbToHex(); //возвращает "прозрачный"

Смотрите также:

Utility Functions

Функция: $A

Создает копию массива. Полезен для применения Array прототипов для итерации объектов, таких как элементы DOM или аргументы объекта.

Синтаксис:

var copiedArray = $A(iterable);

Аргументы:

  1. итерационный - (array) Итерированная копия.

Возвращает:

  • (array) Новую копию массива.

Примеры:

Применяет массив к аргументам:

function myFunction(){
    $A(arguments).each(function(argument, index){

        alert(argument);
    });
};
myFunction("One", "Two", "Three"); //Предупреждение "One", потом "Two", затем "Three".

Copy an Array:

var anArray = [0, 1, 2, 3, 4];

var copiedArray = $A(anArray); //возвращает [0, 1, 2, 3, 4].

Эта документация распостраняется на правах Attribution-NonCommercial-ShareAlike 3.0 License.
Оригинал документации на английском.
© Linux.ria.ua, 2008-2024