array_map

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

array_mapBelirtilen dizilerin elemanlarına geriçağırım işlevini uygular

Açıklama

array_map ( callable|null $işlev , array $dizi , array ...$diziler ) : array

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.

Değiştirgeler

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.

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 değiştirgesinin 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 = [12345];
$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($funcrange(15)));
?>
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 = [12345];
$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 
= [12345];
$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 
= [123];
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"
  }
}

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