(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
array_map — Belirtilen dizilerin elemanlarına geriçağırım işlevini uygular
array_map() işlevi belirtilen dizinin
(diziler
ile daha fazla dizi belirtilmişse, onların
da) ilgili elemanlarının her birine işlev
geri çağırım
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şlev
Her dizinin her elemanına uygulanacak callable türünde geri çağırım işlevi.
Çok sayıda diziye bir zip işlemi uygulamak için
işlev
'e değer olarak null
aktarılabilir.
Sadece dizi
sağlanmışsa,
array_map() girilen diziyle döner.
dizi
Elemanları işlev
tarafından işlenecek ilk dizi.
diziler
Elemanları işlev
tarafından işlenecek diğer
dizilerin ek değişken listesi.
array_map() işlevi belirtilen dizinin
(diziler
ile daha fazla dizi belirtilmişse, onların
da) ilgili elemanlarının her birine işlev
geri çağırım
işlevini uygulayıp sonucu bir dizi olarak döndürür.
Döndürülen dizi, yalnız ve yalnız tek bir dizi aktarılırsa, dizi değiştirgesinin anahtarlarını korur. Birden fazla dizi aktarılırsa, döndürülen dizi sıralı tamsayı anahtarlara sahip olacaktır.
Örnek 1 - array_map() örneği
<?php
function cube($n)
{
return ($n * $n * $n);
}
$a = [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: {$m}");
}
function map_Spanish($n, $m)
{
return [$n => $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);
?>
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 - Dizileri ziplemek
<?php
$a = [1, 2, 3, 4, 5];
$b = ['one', 'two', 'three', 'four', 'five'];
$c = ['uno', 'dos', 'tres', 'cuatro', 'cinco'];
$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ş ) )
Örnek 5 - Tek dizi
ile
null
işlev
<?php
$array = [1, 2, 3];
var_dump(array_map(null, $array));
?>
Yukarıdaki örneğin çıktısı:
array(3) { [0]=> int(1) [1]=> int(2) [2]=> int(3) }
Örnek 6 - Dizgesel anahtarlarla array_map() örneği
<?php
$arr = ['anahtar' => 'değer'];
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));
?>
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" } }