WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

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

Quellen