CKTIS / PHP
array_map: převod hodnot pole
array_map vytváří pole výsledků callbacku pro postupné hodnoty. Při jednom vstupním poli zachovává klíče; při více polích vytvoří souvislé číselné klíče.
Verze: PHP 8.4
Syntaxe
array_map(?callable $callback, array $array, array ...$arrays): arrayCallback má vracet novou hodnotu. fn(int $value): int => $value * 2 zdvojnásobí číslo. Pouhé echo v callbacku vypíše text, ale nenahradí vrácení výsledku. Běžné mapování skalárů nemění zdrojové pole.
U jednoho pole zůstávají textové i číselné klíče zachovány. U více polí se hodnoty párují podle pozice v pořadí iterace, nikoli podle shody klíčů. Kratší pole se doplní hodnotami null; zohledni to v typech i logice callbacku.
Callback null u více polí vytvoří pole odpovídajících hodnot. U jediného pole vrátí toto pole. Příklad ukazuje mapování se zachováním klíčů a takové spojení dvou polí různé délky.
array_map nefiltruje prvky: i vrácené null se stane hodnotou výsledku. Pro výběr prvků použij array_filter. Nepovažuj mapování za hlubokou kopii objektů; callback může změnit předaný objekt nebo mít jiné vedlejší účinky.
Příklady
<?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";
Výsledek
{"a":4,"b":6}
[[1,10],[2,null]]