map(input_array: Array, converter_function: function, function_context: Array);
input_array. Исходный массив;
converter_function. Функция, выполняемая над элементами исходного массива. Имеет следующие параметры: element - элемент массива, element_index - его индекс , input_array - исходной массив;
function_context. Контекст вызова функции.
Метод map определяет массив, каждый элемент которого является результатом выполнения указанной функции над соответствующим ему элементом в исходном массиве.
Метод возвращает значение типа Array.
Для выполнения примера необходимо наличие на html-странице ссылки на файл сценария PP.GraphicsBase.js. Определим массив целых чисел, а затем увеличим каждый его элемент в два раза:
// Определим массив целых чисел
var elements = [5, 9, 6, 7, 2];
console.log("Исходный массив элементов: [" + elements + "]");
// Определим возвратную функцию
var callback = function (element) {
element *= 2;
return element;
};
var map = PP.map(elements, callback, this);
console.log("Новый массив элементов: [" + map + "]");
В результате выполнения примера в консоли браузера были выведены целочисленные элементы массива, увеличенные в два раза:
Исходный массив элементов: [5,9,6,7,2]
Новый массив элементов: [10,18,12,14,4]
См. также: