KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

array_map: arraywaarden omzetten

array_map bouwt een array van callbackresultaten voor opeenvolgende waarden. Bij één invoerarray blijven sleutels behouden; bij meerdere ontstaan opeenvolgende numerieke sleutels.

Versie: PHP 8.4

Syntax

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

De callback moet een nieuwe waarde teruggeven. fn(int $value): int => $value * 2 verdubbelt een getal. Alleen echo gebruiken in de callback schrijft tekst uit, maar vervangt het teruggeven van een resultaat niet. Gewoon mappen van scalaire waarden verandert de bronarray niet.

Bij één array blijven tekstuele en numerieke sleutels behouden. Bij meerdere worden waarden gekoppeld op hun positie in de iteratievolgorde, niet op overeenkomstige sleutels. Kortere arrays worden aangevuld met null; houd daar rekening mee in typen en callbacklogica.

Een null-callback maakt bij meerdere arrays arrays met overeenkomstige waarden. Bij één array geeft hij die array terug. Het voorbeeld toont mapping met behoud van sleutels en deze combinatie van twee arrays met verschillende lengten.

array_map filtert geen elementen: ook een teruggegeven null wordt een resultaatwaarde. Gebruik array_filter om elementen te selecteren. Beschouw mapping niet als een diepe kopie van objecten; een callback kan een ontvangen object wijzigen of andere neveneffecten hebben.

Voorbeelden

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

Resultaat

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

Bronnen