array_map
Wendet eine Callback-Funktion auf die Elemente von Arrays an
&reftitle.description;
arrayarray_map
callablecallback
arrayarray1
array...
array_map gibt ein &array; zurück, das die Ergebnisse der
Anwendung der callback Funktion auf den entsprechenden Index von
array1 (und ..., wenn weitere Arrays angegeben wurden)
als Callback-Argumente enthält.
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.
&null; kann als Wert an callback übergeben werden,
um eine zip-Operation auf mehrere Arrays durchzuführen.
Wird nur array1 übergeben,
gibt array_map das Eingabe-Array zurück.
array1
Ein Array, auf das die callback-Funktion
angewendet werden soll.
...
Zusätzliche variable Liste von Array-Argumenten, auf die die
callback-Funktion angewendet werden soll.
&reftitle.returnvalues;
array_map gibt ein Array zurück, das die Ergebnisse der
Anwendung der callback Funktion auf den entsprechenden Index von
array1 (und ..., wenn weitere Arrays angegeben wurden)
als Callback-Argumente enthält.
&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
)
]]>
<function>array_map</function> - Verwendung mehrerer Arrays
$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;
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, werden kürzere um leere Elemente
erweitert, um mit der Länge des längsten übereinzustimmen.
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.
Durchführen einer zip-Operation von 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
)
)
]]>
Das zurückgelieferte Array erhält die Schlüssel des Array-Arguments nur,
wenn genau ein Array übergeben wurde. Wird mehr als ein Array übergeben,
hat das zurückgelieferte Array sequentielle Integer-Schlüssel.
&null; <parameter>callback</parameter> nur mit <parameter>array1</parameter>
]]>
&example.outputs;
int(1)
[1]=>
int(2)
[2]=>
int(3)
}
]]>
<function>array_map</function> - mit String-Schlüsseln
'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;