(PHP 4 >= 4.0.6, PHP 5, PHP 7)
array_map — Belirtilen dizilerin elemanlarına geriçağırım işlevini uygular
array_map() işlevi belirtilen dizilerin elemanlarının
her birine işlev işlevini uygulayıp sonucu bir dizi
olarak döndürür. Geriçağırım işlevinin değiştirge sayısı
array_map() işlevine aktarılan değiştirge sayısını kabul
edebilmelidir.
işlevHer dizinin her elemanına uygulanacak geri çağırım işlevi.
dizi1
Elemanları işlev tarafından işlenecek ilk dizi.
array
Elemanları işlev tarafından işlenecek diğer
diziler.
Belirtilen dizilerin elemanlarının her birine işlev
işlevini uyguladıktan sonra oluşan diziyi döndürür.
Örnek 1 - array_map() örneği
<?php
function cube($n)
{
return($n * $n * $n);
}
$a = array(1, 2, 3, 4, 5);
$b = array_map("cube", $a);
print_r($b);
?>
$b şöyle olur:
Array
(
[0] => 1
[1] => 8
[2] => 27
[3] => 64
[4] => 125
)
Örnek 2 - Lamda işlevi kullanan array_map() örneği (PHP 5.3.0 ve sonrası)
<?php
$func = function($deger) {
return $deger * 2;
};
print_r(array_map($func, range(1, 5)));
?>
Array
(
[0] => 2
[1] => 4
[2] => 6
[3] => 8
[4] => 10
)
Örnek 3 - Birden fazla diziyle array_map() örneği
<?php
function show_Spanish($n, $m)
{
return("İspanyolcada $n sayısının ismi:");
}
function map_Spanish($n, $m)
{
return(array($n => $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);
?>
Yukarıdaki örneğin çıktısı:
// $c çıktısı
Array
(
[0] => İspanyolcada 1 sayısının ismi: uno
[1] => İspanyolcada 2 sayısının ismi: dos
[2] => İspanyolcada 3 sayısının ismi: tres
[3] => İspanyolcada 4 sayısının ismi: cuatro
[4] => İspanyolcada 5 sayısının ismi: cinco
)
// $d çıktısı
Array
(
[0] => Array
(
[1] => uno
)
[1] => Array
(
[2] => dos
)
[2] => Array
(
[3] => tres
)
[3] => Array
(
[4] => cuatro
)
[4] => Array
(
[5] => cinco
)
)
İki veya daha fazla sayıda dizi kullanırken işlev elemanlara karşılıklı uygulanacağından normal olarak dizilerin eleman sayılarının eşit olması gerekir. Eğer bu eşitlik yoksa, kısa olanlar boş elemanlar eklenerek en uzun olanın boyuna eşitlenir
Bu işlevin ilginç bir kullanımı da, geriçağırım işlevi ismi olarak NULL
belirterek bir diziler dizisi oluşturmaktır.
Örnek 4 - Bir diziler dizisi oluşturmak
<?php
$a = array(1, 2, 3, 4, 5);
$b = array("one", "two", "three", "four", "five");
$c = array("bir", "iki", "üç", "dört", "beş");
$d = array_map(null, $a, $b, $c);
print_r($d);
?>
Yukarıdaki örneğin çıktısı:
Array
(
[0] => Array
(
[0] => 1
[1] => one
[2] => bir
)
[1] => Array
(
[0] => 2
[1] => two
[2] => iki
)
[2] => Array
(
[0] => 3
[1] => three
[2] => üç
)
[3] => Array
(
[0] => 4
[1] => four
[2] => dört
)
[4] => Array
(
[0] => 5
[1] => five
[2] => beş
)
)
Eğer dizi elemanları dizgesel anahtarlar içeriyorsa, sadece aynı anahtara sahip olmayan elemanlar dizgesel anahtarlarıyla içerilir. Eğer aynı anahtara sahip birden fazla eleman varsa dönen dizi bu elemanları daima sayısal indisli olarak içerir.
Örnek 5 - Dizgesel anahtarlarla array_map() örneği
<?php
$arr = array("anahtar" => "değer");
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));
?>
Yukarıdaki örneğin çıktısı:
array(1) {
["anahtar"]=>
array(1) {
[0]=>
string(5) "deger"
}
}
array(1) {
[0]=>
array(2) {
[0]=>
string(5) "deger"
[1]=>
string(5) "deger"
}
}
array(1) {
["stringkey"]=>
string(5) "deger"
}
array(1) {
[0]=>
array(2) {
[0]=>
string(5) "deger"
[1]=>
string(5) "deger"
}
}