Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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): array

Callback 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]]

Zdroje