array_map

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

array_map — Aplica una función a los elementos de un array

Descripción

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

array_map() devuelve un array que contiene los resultados de la aplicación de la función de retrollamada callback a la correspondiente array (y arrays si se proporcionan más arrays) utilizados como argumentos para la función de retrollamada. El número de parámetros que la función de retrollamada callback acepta debería corresponder al número de arrays pasados a array_map(). Los arrays de entrada adicionales son ignorados. Se lanza una ArgumentCountError si se proporciona un número insuficiente de argumentos.

Parámetros

callback

La función de retrollamada de tipo callable a ejecutar para cada elemento de cada array.

null puede ser pasado como valor a callback para ejecutar una operación zip en múltiples arrays y devolver un array cuyos elementos son cada uno un array que contiene los elementos de los arrays de entrada que tienen el mismo índice (ver el ejemplo a continuación). Si solo se proporciona array, array_map() devolverá el array de entrada.

array

Un array a ejecutar a través de la función de retrollamada callback.

arrays

Lista variable de argumentos de arrays adicionales a ejecutar a través de la función de retrollamada callback.

Valores devueltos

Devuelve un array que contiene los resultados de la aplicación de la función de retrollamada callback al valor correspondiente de array (y arrays si se proporcionan más arrays) utilizados como argumentos para la función de retrollamada.

El array devuelto conservará las claves del array pasado como argumento, si y solo si, se pasa un solo array. Si se pasan múltiples arrays como argumento, el array devuelto tendrá claves secuenciales en forma de int.

Historial de cambios

Versión	Descripción
8.0.0	Si `callback` espera que se pase un parámetro por referencia, esta función ahora emitirá un `E_WARNING`.

Ejemplos

Ejemplo #1 Ejemplo con array_map()

<?php
function cube($n)
{
    return ($n * $n * $n);
}

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

El contenido de la variable $b será :

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

Ejemplo #2 array_map() utilizando una función cualquiera

<?php

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

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

// O a partir de 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
)

Ejemplo #3 array_map() : utilización de múltiples arrays

<?php
function show_Spanish(int $n, string $m): string
{
    return "El número {$n} se dice {$m} en Español";
}

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);
?>