Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / PHP

array_map: transformar valores de un array

array_map construye un array con los resultados de un callback aplicado a valores sucesivos. Con un array conserva las claves; con varios crea claves numéricas consecutivas.

Versión: PHP 8.4

Sintaxis

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

El callback debe devolver un valor nuevo. fn(int $value): int => $value * 2 duplica un número. Usar únicamente echo en el callback muestra texto, pero no sustituye la devolución del resultado. El mapeo normal de escalares no cambia el array original.

Con un array se conservan las claves de texto y numéricas. Con varios se emparejan valores por posición en el orden de iteración, no por coincidencia de claves. Los arrays más cortos se rellenan con null; tenlo en cuenta en los tipos y la lógica del callback.

Un callback null con varios arrays crea arrays de valores correspondientes. Con uno devuelve ese array. El ejemplo muestra un mapeo que conserva claves y esta combinación de dos arrays de distinta longitud.

array_map no filtra elementos: un null devuelto también se convierte en un valor del resultado. Usa array_filter para seleccionar elementos. No consideres el mapeo una copia profunda de objetos; un callback puede modificar un objeto recibido o tener otros efectos secundarios.

Ejemplos

<?php
declare(strict_types=1);

$values = ["a" => 2, "b" => 3];
$mapped = array_map(fn(int $value): int => $value * 2, $values);
echo json_encode($mapped, JSON_THROW_ON_ERROR), "\n";
$paired = array_map(null, [1, 2], [10]);
echo json_encode($paired, JSON_THROW_ON_ERROR), "\n";

Resultado

{"a":4,"b":6}
[[1,10],[2,null]]

Fuentes