CKTIS / PHP
array_map: transformar valores de um array
array_map cria um array com os resultados de um callback aplicado aos valores sucessivos. Com um array conserva as chaves; com vários cria chaves numéricas consecutivas.
Versão: PHP 8.4
Sintaxe
array_map(?callable $callback, array $array, array ...$arrays): arrayO callback deve devolver um novo valor. fn(int $value): int => $value * 2 duplica um número. Usar apenas echo no callback escreve texto, mas não substitui a devolução de um resultado. O mapeamento normal de escalares não altera o array original.
Com um array, as chaves textuais e numéricas são preservadas. Com vários, os valores são associados pela posição na ordem de iteração, não por coincidência das chaves. Os arrays mais curtos são preenchidos com null; considera isso nos tipos e na lógica do callback.
Um callback null com vários arrays cria arrays de valores correspondentes. Com um único array devolve esse array. O exemplo mostra o mapeamento com preservação das chaves e esta combinação de dois arrays de comprimentos diferentes.
array_map não filtra elementos: um null devolvido também passa a ser um valor do resultado. Usa array_filter para selecionar elementos. Não consideres o mapeamento uma cópia profunda de objetos: um callback pode alterar um objeto recebido ou ter outros efeitos secundários.
Exemplos
<?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]]