array_map

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

array_map — Применяет callback-функцию к элементам массивов

Описание

array_map(?callable $callback, array $array, array ...$arrays): array

Функция array_map() возвращает массив (array), который содержит результаты обработки callback-функцией значений массива array, и значений массивов arrays, если в функцию передали больше одного массива, которые функция передаёт как аргументы в callback-функцию. При вызове функции array_map() проверяют, чтобы количество массивов, которое передают в функцию, совпадало с количеством параметров callback-функции. Функция проигнорирует лишние входные массивы. При передаче недостаточного количества аргументов функция выбросит исключение ArgumentCountError.

Список параметров

callback

Значение с типом callable, которое функция вызовет на каждом элементе в каждом массиве.

При передаче аргумента callback со значением null функция выполнит с массивами zip-операцию и вернёт массив массивов, каждый из которых содержит элементы входных массивов с одними и теми же индексами, как в примере ниже. Функция array_map() вернёт входной массив, если передали только аргумент array.

array

Массив, который функция передаст в callback-функцию.

arrays

Дополнительные массивы для обработки callback-функцией.

Возвращаемые значения

Функция возвращает массив, который содержит результаты обработки callback-функцией значений массива array, и значений массивов arrays, если в функцию передали больше одного массива, которые функция передаёт как аргументы в callback-функцию.

Массив, который вернёт функция, сохранит ключи аргумента-массива, только если в функцию передали ровно один массив. Массив, который возвращает функция, будет содержать последовательные целочисленные ключи, если передали больше одного массива.

Список изменений

Версия	Описание
8.0.0	Теперь функция выдаст ошибку уровня `E_WARNING`, если параметр `callback` ожидает, что значение передадут по ссылке.

Примеры

Пример #1 Пример использования функции array_map()

<?php

function cube($n)
{
    return ($n * $n * $n);
}

$a = [1, 2, 3, 4, 5];
$b = array_map('cube', $a);
print_r($b);

?>

В результате переменная $b будет содержать:

Array
(
    [0] => 1
    [1] => 8
    [2] => 27
    [3] => 64
    [4] => 125
)

Пример #2 Пример работы функции array_map() с лямбда-функцией

<?php

$func = function(int $value): int {
    return $value * 2;
};

print_r(array_map($func, range(1, 5)));

// Или с PHP 7.4.0:

print_r(
    array_map(
        fn($value): int => $value * 2,
        range(1, 5)
    )
);

?>

Array
(
    [0] => 2
    [1] => 4
    [2] => 6
    [3] => 8
    [4] => 10
)

Пример #3 Пример работы функции array_map() с набором массивов

<?php

function show_Spanish(int $n, string $m): string
{
    return "Число {$n} по-испански называется {$m}";
}

function map_Spanish(int $n, string $m): array
{
    return [$n => $m];
}

$a = [1, 2, 3, 4, 5];
$b = ['uno', 'dos', 'tres', 'cuatro', 'cinco'];

$c = array_map('show_Spanish', $a, $b);
print_r($c);

$d = array_map('map_Spanish', $a, $b);
print_r($d);

?>