array_map
Belirtilen dizilerin elemanlarına geriçağırım işlevini uygular
&reftitle.description;
arrayarray_map
callablenullişlev
arraydizi
arraydiziler
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.
&reftitle.parameters;
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.
&reftitle.returnvalues;
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.
&reftitle.changelog;
&Version;
&Description;
&array.changelog.by-ref;
&reftitle.examples;
- <function>array_map</function> örneği
]]>
$b şöyle olur:
1
[1] => 8
[2] => 27
[3] => 64
[4] => 125
)
]]>
- Lamda işlevi kullanan <function>array_map</function> örneği
$value * 2, range(1, 5)));
?>
]]>
2
[1] => 4
[2] => 6
[3] => 8
[4] => 10
)
]]>
- Birden fazla diziyle <function>array_map</function> örneği
$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;
İ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.
- Dizileri ziplemek
]]>
&example.outputs;
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ş
)
)
]]>
- Tek <parameter>dizi</parameter> ile
&null; <parameter>işlev</parameter>
]]>
&example.outputs;
int(1)
[1]=>
int(2)
[2]=>
int(3)
}
]]>
- Dizgesel anahtarlarla <function>array_map</function> örneği
'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));
?>
]]>
&example.outputs;
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"
}
}
]]>
- <function>array_map</function> 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.
'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);
?>
]]>
&example.outputs;
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"
}
]]>
&reftitle.seealso;
array_filter
array_reduce
array_walk