Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / PHP

array_map: trasformare i valori di un array

array_map costruisce un array dei risultati di un callback applicato ai valori successivi. Con un solo array conserva le chiavi; con più array crea chiavi numeriche consecutive.

Versione: PHP 8.4

Sintassi

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

Il callback deve restituire un nuovo valore. fn(int $value): int => $value * 2 raddoppia un numero. Usare solo echo nel callback stampa testo ma non sostituisce la restituzione del risultato. Il normale mapping di scalari non modifica l'array di origine.

Con un array vengono conservate le chiavi testuali e numeriche. Con più array, i valori vengono abbinati per posizione nell'ordine di iterazione, non per corrispondenza delle chiavi. Gli array più corti vengono completati con null: consideralo nei tipi e nella logica del callback.

Un callback null con più array crea array di valori corrispondenti. Con un solo array restituisce quell'array. L'esempio mostra il mantenimento delle chiavi e questa combinazione di due array di lunghezze diverse.

array_map non filtra gli elementi: anche un null restituito diventa un valore del risultato. Usa array_filter per selezionare elementi. Non considerare il mapping una copia profonda degli oggetti: un callback può modificare un oggetto ricevuto o avere altri effetti collaterali.

Esempi

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

Risultato

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

Fonti