(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 bağımsız değişken sayısı array_map() işlevine aktarılan bağımsız değişken sayısını kabul edebilmelidir. Fazladan belirtilen diziler yok sayılır. Bağımsız değişken sayısı yetersizse ArgumentCountError yavrulanır.
işlevHer 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 bağımsız değişkeninin anahtarlarını korur. Birden fazla dizi aktarılırsa, döndürülen dizi sıralı tamsayı anahtarlara sahip olacaktır.
| Sürüm: | Açıklama |
|---|---|
| 8.0.0 | Eğer işleve bağımsız değişkenlerinden biri gönderimli aktarılıyorsa, bu artık E_WARNING seviyesinde bir uyarıya sebep oluyor. |
Ö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
$func = function(int $deger): int {
return $deger * 2;
};
print_r(array_map($func, range(1, 5)));
// Veya PHP 7.4.0 ve sonrasında:
print_r(array_map(fn($value): int => $value * 2, 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(int $n, string $m): string
{
return("İspanyolcada {$n} sayısının ismi: {$m}");
}
function map_Spanish(int $n, string $m): array
{
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 )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 nulliş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" } }Örnek 7 - array_map() ve ilişkisel diziler
array_map() dizi anahtarlarının doğrudan girdi olarak kullanımını desteklemese de array_keys() kullanılarak bu yapılabilir.
<?php
$arr = [
'v1' => 'ilk sürüm',
'v2' => 'ikinci sürüm',
'v3' => 'üçüncü sürüm',
];
// Bilgi: 7.4.0 öncesinde, anonim işlevler için bunun yerine uzun
// sözdizimi kullanılırdı.
$callback = fn(string $k, string $v): string => "$k$v idi";
$result = array_map($callback, array_keys($arr), array_values($arr));
var_dump($result);
?>Yukarıdaki örneğin çıktısı:
array(3) { [0]=> string(24) "v1 ilk sürüm idi" [1]=> string(25) "v2 ikinci sürüm idi" [2]=> string(24) "v3 üçüncü sürüm idi" }