CKTIS / PHP
array_map: Array-Werte umwandeln
array_map erstellt ein Array aus Callback-Ergebnissen für aufeinanderfolgende Werte. Bei einem Eingabearray bleiben Schlüssel erhalten; bei mehreren entstehen fortlaufende numerische Schlüssel.
Version: PHP 8.4
Syntax
array_map(?callable $callback, array $array, array ...$arrays): arrayDer Callback sollte einen neuen Wert zurückgeben. fn(int $value): int => $value * 2 verdoppelt eine Zahl. Ein bloßes echo im Callback gibt Text aus, ersetzt aber keine Rückgabe. Gewöhnliches Mapping skalarer Werte verändert das Quellarray nicht.
Bei einem Array bleiben Zeichenketten- und Zahlenschlüssel erhalten. Bei mehreren werden Werte nach ihrer Position in der Iterationsreihenfolge kombiniert, nicht nach übereinstimmenden Schlüsseln. Kürzere Arrays werden mit null aufgefüllt; berücksichtige das in Typen und Logik des Callbacks.
Ein null-Callback erzeugt bei mehreren Arrays Arrays entsprechender Werte. Bei einem Array gibt er dieses zurück. Das Beispiel zeigt Mapping mit erhaltenen Schlüsseln und diese Kombination zweier unterschiedlich langer Arrays.
array_map filtert keine Elemente: Auch ein zurückgegebenes null wird zum Ergebniswert. Verwende array_filter zur Auswahl von Elementen. Betrachte Mapping nicht als tiefe Kopie von Objekten; ein Callback kann ein übergebenes Objekt verändern oder andere Nebenwirkungen haben.
Beispiele
<?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";
Ergebnis
{"a":4,"b":6}
[[1,10],[2,null]]