Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / PHP

array_map: transformácia hodnôt poľa

array_map vytvára pole výsledkov callbacku pre postupné hodnoty. Pri jednom vstupnom poli zachováva kľúče; pri viacerých vytvorí súvislé číselné kľúče.

Verzia: PHP 8.4

Syntax

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

Callback má vrátiť novú hodnotu. fn(int $value): int => $value * 2 zdvojnásobí číslo. Samotné echo v callbacku vypíše text, ale nenahradí vrátenie výsledku. Bežné mapovanie skalárov nemení zdrojové pole.

Pri jednom poli sa zachovajú textové aj číselné kľúče. Pri viacerých sa hodnoty párujú podľa pozície v poradí iterácie, nie podľa zhody kľúčov. Kratšie polia sa doplnia hodnotami null; zohľadni to v typoch aj logike callbacku.

Callback null pri viacerých poliach vytvorí polia zodpovedajúcich hodnôt. Pri jedinom poli vráti toto pole. Príklad ukazuje mapovanie so zachovaním kľúčov a takéto spojenie dvoch polí rôznej dĺžky.

array_map nefiltruje prvky: aj vrátené null sa stane hodnotou výsledku. Na výber prvkov použi array_filter. Nepovažuj mapovanie za hlbokú kópiu objektov; callback môže zmeniť odovzdaný objekt alebo mať iné vedľajšie účinky.

Prí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ýsledok

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

Zdroje