array_map
Wendet eine Callback-Funktion auf die Elemente von Arrays an
&reftitle.description;
arrayarray_map
callbackcallback
arrayarr1
array...
array_map gibt ein Array mit allen Elementen von
arr1 zurück, nachdem die Callback-Funktion
callback auf jedes einzelne Element angewandt
wurde. Die Anzahl Parameter, welche die Callback-Funktion
callback akzeptiert, sollte der Anzahl der an
array_map übergebenen Arrays entsprechen.
&reftitle.parameters;
callback
Callback-Funktion, die für jedes Element in jedem Array
aufgerufen werden soll.
arr1
Ein Array, auf das die callback-Funktion
angewendet werden soll.
array
Variable Liste von Array-Argumenten, auf die die
callback-Funktion angewendet werden soll.
&reftitle.returnvalues;
Gibt ein Array zurück, dass alle Elemente von
arr1 enthält, nachdem die
callback-Funktion auf jedes Element
angewendet wurde.
&reftitle.examples;
<function>array_map</function>-Beispiel
]]>
Dies speichert in $b:
1
[1] => 8
[2] => 27
[3] => 64
[4] => 125
)
]]>
<function>array_map</function> mit einer Lambda-Funktion
(seit PHP 5.3.0)
]]>
2
[1] => 4
[2] => 6
[3] => 8
[4] => 10
)
]]>
&reftitle.examples;
<function>array_map</function> - Verwendung mehrerer Arrays
$m));
}
$a = array(1, 2, 3, 4, 5);
$b = array("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;
Die Zahl 1 heißt auf Spanisch uno
[1] => Die Zahl 2 heißt auf Spanisch dos
[2] => Die Zahl 3 heißt auf Spanisch tres
[3] => Die Zahl 4 heißt auf Spanisch cuatro
[4] => Die Zahl 5 heißt auf Spanisch cinco
)
// Ausgabe von $d
Array
(
[0] => Array
(
[1] => uno
)
[1] => Array
(
[2] => dos
)
[2] => Array
(
[3] => tres
)
[3] => Array
(
[4] => cuatro
)
[4] => Array
(
[5] => cinco
)
)
]]>
Bei Verwendung von zwei oder mehr Arrays sollten diese gewöhnlich
die gleiche Länge besitzen, da die Callback-Funktion parallel auf
die entsprechenden Elemente angewandt wird. Haben die Arrays
unterschiedliche Längen, wird das kürzeste um leere Elemente
erweitert.
Eine interessante Anwendung dieser Funktion ist die Konstruktion
eines Arrays bestehend aus Arrays, was mit &null; als Name der
Callback-Funktion leicht realisiert werden kann.
Erstellen eines Arrays mit Arrays
]]>
&example.outputs;
Array
(
[0] => 1
[1] => eins
[2] => uno
)
[1] => Array
(
[0] => 2
[1] => zwei
[2] => dos
)
[2] => Array
(
[0] => 3
[1] => drei
[2] => tres
)
[3] => Array
(
[0] => 4
[1] => vier
[2] => cuatro
)
[4] => Array
(
[0] => 5
[1] => fünf
[2] => cinco
)
)
]]>
Wenn das Array-Argument String-Schlüssel enthält, wird das
zurückgegebene Array String-Schlüssel enthalten sofern genau ein
Array übergeben wurde. Sollten mehrere Arrays übergeben werden,
so hat das zurückgegebene Array immer Integer-Schlüssel.
<function>array_map</function> - mit String-Schlüsseln
"value");
function cb1($a) {
return array ($a);
}
function cb2($a, $b) {
return array ($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
create_function
&seealso.callback;