array_map
Применяет функцию к каждому элементу массива.
Доступно с: PHP 4
Синтаксис
array_map(?callable $callback, array $array, array ...$arrays): arrayПараметры
| Параметр | Тип | Описание |
|---|---|---|
| $callback | ?callable | Функция, которая получает элемент и возвращает новое значение. |
| $array | array | Исходный массив. |
| ...$arrays | array | Дополнительные массивы: их элементы передаются в функцию следующими аргументами. |
Возвращаемое значение
arrayНовый массив с результатами вызова функции.
Примеры
Удвоение каждого числа:
<?php
print_r(array_map(fn ($n) => $n * 2, [1, 2, 3]));Результат:
Array
(
[0] => 2
[1] => 4
[2] => 6
)Вместо своей функции можно передать имя готовой:
<?php
echo implode(', ', array_map('mb_strtoupper', ['php', 'js']));Результат:
PHP, JSПримечания
Исходный массив не меняется — функция возвращает новый. Чтобы отобрать часть элементов, а не преобразовать их, используйте array_filter().
См. также
- array_filter — Оставляет в массиве элементы, прошедшие проверку.
Вопросы и ответы по теме
В учебнике
- Функции — Как объявлять и вызывать функции в PHP — параметры, возврат значения, типы и область видимости.