Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / PHP

array_map: pretvarjanje vrednosti polja

array_map ustvari polje rezultatov povratne klicne funkcije za zaporedne vrednosti. Pri enem vhodnem polju ohrani ključe; pri več poljih ustvari zaporedne številske ključe.

Različica: PHP 8.4

Sintaksa

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

Povratna klicna funkcija mora vrniti novo vrednost. fn(int $value): int => $value * 2 podvoji število. Sam echo v tej funkciji izpiše besedilo, ne nadomesti pa vračanja rezultata. Običajno preslikavanje skalarjev ne spremeni izvornega polja.

Pri enem polju se ohranijo besedilni in številski ključi. Pri več poljih se vrednosti združujejo po položaju v vrstnem redu iteracije, ne po enakosti ključev. Krajša polja se dopolnijo z null; to upoštevaj pri tipih in logiki funkcije.

Povratna klicna funkcija null pri več poljih ustvari polja pripadajočih vrednosti. Pri enem polju vrne to polje. Primer pokaže preslikavanje z ohranjenimi ključi in takšno združitev dveh polj različnih dolžin.

array_map ne filtrira elementov: tudi vrnjeni null postane vrednost rezultata. Za izbiro elementov uporabi array_filter. Preslikavanja ne obravnavaj kot globoko kopiranje objektov; funkcija lahko spremeni prejeti objekt ali ima druge stranske učinke.

Primeri

<?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";

Rezultat

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

Viri