CKTIS / PHP
array_map: przekształcanie wartości tablicy
array_map buduje tablicę wyników callbacku wywołanego dla kolejnych wartości. Przy jednej tablicy zachowuje klucze; przy wielu tworzy kolejne klucze liczbowe.
Wersja: PHP 8.4
Składnia
array_map(?callable $callback, array $array, array ...$arrays): arrayCallback powinien zwracać nową wartość. fn(int $value): int => $value * 2 podwaja liczbę. Samo echo w callbacku wypisze tekst, lecz nie zastąpi zwrócenia wyniku. Zwykłe mapowanie skalarów nie zmienia tablicy źródłowej.
Dla jednej tablicy zachowane są klucze tekstowe i liczbowe. Przy kilku tablicach wartości są łączone według pozycji w kolejności iteracji, nie według zgodności kluczy. Krótsze tablice są uzupełniane null; uwzględnij to w typach i logice callbacku.
Callback null przy kilku tablicach tworzy tablice odpowiadających sobie wartości. Przy jednej zwraca tę tablicę. Przykład pokazuje mapowanie z zachowaniem kluczy oraz takie łączenie dwóch tablic o różnej długości.
array_map nie filtruje elementów: zwrócone null też staje się wartością wyniku. Do wyboru elementów służy array_filter. Nie traktuj mapowania jako głębokiego kopiowania obiektów; callback może zmienić przekazany obiekt lub wywołać inne skutki uboczne.
Przykłady
<?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";
Wynik
{"a":4,"b":6}
[[1,10],[2,null]]