array_map
(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
array_map — Belirtilen dizilerin elemanlarına geriçağırım işlevini uygular
Bağımsız Değişkenler
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; bu
durumda her elemanı, dahili dizi göstergesinin aynı konumundaki girdi
dizilerinin elemanlarını içeren bir dizi olan bir dizi döndürülür
(aşağıdaki örneğe bakın). 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.
Dönen Değerler
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.
Örnekler
Ö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);
?>
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)));
?>
Yukarıdaki örneğin çıktısı:
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
)
// $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"
}
}
Ö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"
}
Ayrıca Bakınız
- array_filter() - Bir dizinin elemanlarını bir geriçağırım işleviyle süzgeçten
geçirir
- array_reduce() - Bir geriçağırım işlevini dizinin bütün elemanlarına tek tek
uygulayıp sonucu döndürür
- array_walk() - Bir dizinin her üyesine kullanıcı tanımlı bir işlevi uygular