array_map
Applique une fonction sur les éléments d'un tableau
&reftitle.description;
arrayarray_map
callablecallback
arrayarray1
array...
array_map retourne un &array; contenant
les résultats de l'application de la fonction de rappel
callback à l'index correspondant de
array1 (et ... si plus de
tableaux sont fourni) utilisé en tant qu'arguments pour la fonction de rappel.
Le nombre de paramètres que la fonction de rappel callback
accepte devrait correspondre au nombre de tableaux passé à
array_map.
&reftitle.parameters;
callback
La fonction de rappel à exécuter pour chaque élément de chaque
tableau.
&null; peut être passé comme valeur à callback
pour executer une opération zip sur plusieurs tableaux.
Si seulement array1 est fourni,
array_map retournera le tableau d'entré.
array1
Un tableau à exécuter via la fonction de rappel callback.
...
Liste variable d'arguments tableaux supplémentaires à exécuter via
la fonction de rappel callback.
&reftitle.returnvalues;
Retourne un tableau contenant les résultats de l'application de la fonction
de rappel callback à l'index correspondant de
array1 (et ... si plus de
tableaux sont fourni) utilisé en tant qu'arguments pour la fonction de rappel.
&reftitle.examples;
Exemple avec <function>array_map</function>
]]>
Le contenu de la variable $b sera :
1
[1] => 8
[2] => 27
[3] => 64
[4] => 125
)
]]>
<function>array_map</function> : utilisation d'une fonction
quelconque (depuis PHP 5.3.0)
]]>
2
[1] => 4
[2] => 6
[3] => 8
[4] => 10
)
]]>
<function>array_map</function> : utilisation de plusieurs tableaux
$m];
}
$a = [1, 2, 3, 4, 5];
$b = ['uno', 'dos', 'tres', 'cuatro', 'cinco'];
$c = array_map('show_Spanish', $a, $b);
print_r($c);
$d = array_map('map_Spanish', $a , $b);
print_r($d);
?>
]]>
&example.outputs;
Le nombre 1 se dit uno en Espagnol
[1] => Le nombre 2 se dit dos en Espagnol
[2] => Le nombre 3 se dit tres en Espagnol
[3] => Le nombre 4 se dit cuatro en Espagnol
[4] => Le nombre 5 se dit cinco en Espagnol
)
// Contenu de $d
Array
(
[0] => Array
(
[1] => uno
)
[1] => Array
(
[2] => dos
)
[2] => Array
(
[3] => tres
)
[3] => Array
(
[4] => cuatro
)
[4] => Array
(
[5] => cinco
)
)
]]>
Généralement, lors de l'utilisation de plusieurs tableaux, ils doivent
être d'égale longueur, car la fonction de rappel est appliquée de manière
similaire à tous les tableaux. Si les tableaux sont de tailles inégales,
les plus petits seront complétés avec des éléments vides pour atteindre
la taille du plus grand.
Une utilisation intéressante de cette fonction est la construction
de tableaux de tableaux, facilement réalisée en passant la valeur
&null; comme nom de fonction de rappel.
Exécution d'une opération zip de tableaux
]]>
&example.outputs;
Array
(
[0] => 1
[1] => one
[2] => uno
)
[1] => Array
(
[0] => 2
[1] => two
[2] => dos
)
[2] => Array
(
[0] => 3
[1] => three
[2] => tres
)
[3] => Array
(
[0] => 4
[1] => four
[2] => cuatro
)
[4] => Array
(
[0] => 5
[1] => five
[2] => cinco
)
)
]]>
Le tableau retourné conservera les clés du tableau passé en argument,
si et seulement si, un seul tableau est passé. Si plusieurs tableaux
sont passés comme argument, le tableau retourné aura des clés sous la
forme d'entier.
&null; <parameter>callback</parameter> avec seulement
<parameter>array1</parameter>
]]>
&example.outputs;
int(1)
[1]=>
int(2)
[2]=>
int(3)
}
]]>
<function>array_map</function> - avec des clés sous la forme de &string;
'value'];
function cb1($a) {
return [$a];
}
function cb2($a, $b) {
return [$a, $b];
}
var_dump(array_map('cb1', $arr));
var_dump(array_map('cb2', $arr, $arr));
var_dump(array_map(null, $arr));
var_dump(array_map(null, $arr, $arr));
?>
]]>
&example.outputs;
array(1) {
[0]=>
string(5) "value"
}
}
array(1) {
[0]=>
array(2) {
[0]=>
string(5) "value"
[1]=>
string(5) "value"
}
}
array(1) {
["stringkey"]=>
string(5) "value"
}
array(1) {
[0]=>
array(2) {
[0]=>
string(5) "value"
[1]=>
string(5) "value"
}
}
]]>
&reftitle.seealso;
array_filter
array_reduce
array_walk
&seealso.callback;