PHP 8.4.2 Released!

    array_map

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

    array_map — Applique une fonction sur les éléments d'un tableau

    Description

    array_map(?callable $callback, array $array, array ...$arrays): array

    array_map() retourne un tableau contenant les résultats de l'application de la fonction de rappel callback à la valeur correspondante de array (et arrays si plus de tableaux sont fournis) utilisé en tant qu'arguments pour la fonction de rappel. Le nombre de paramètres que la fonction de rappel callback accepte devrait correspondre au nombre de tableaux passés à array_map(). Les tableaux d'entrées en surplus sont ignorés. Une ArgumentCountError est lancée si un nombre insuffisant d'arguments est fourni.

    Liste de paramètres

    callback

    La fonction de rappel de type callable à exécuter pour chaque élément de chaque tableau.

    null peut être passé comme valeur à callback pour exécuter une opération zip sur plusieurs tableaux et renvoyer un tableau dont les éléments sont chacun un tableau contenant les éléments des tableaux d'entrée ayant le même indice (voir l'exemple ci-dessous). Si seulement array est fourni, array_map() retournera le tableau d'entrée.

    array

    Un tableau à exécuter via la fonction de rappel callback.

    arrays

    Liste variable d'arguments tableaux supplémentaires à exécuter via la fonction de rappel callback.

    Valeurs de retour

    Retourne un tableau contenant les résultats de l'application de la fonction de rappel callback à la valeur correspondant de array (et arrays si plus de tableaux sont fourni) utilisé en tant qu'arguments pour la fonction de rappel.

    Le tableau retourné conservera les clés du tableau passé en argument, si et seulement si, un seul tableau est passé. Si plusieurs tableaux sont passés comme argument, le tableau retourné aura des clés séquentielles sous la forme d'entier.

    Historique

    Version Description
    8.0.0 Si callback attend un paramètre à être passé par référence, cette fonction émet désormais une E_WARNING.

    Exemples

    Exemple #1 Exemple avec array_map()

    <?php
    function cube($n)
    {
    return (    $n * $n * $n);
    }

    $a = [1, 2, 3, 4, 5];
    $b = array_map('cube', $a);
    print_r($b);
    ?>

    Le contenu de la variable $b sera : 

    Array
(
    [0] => 1
    [1] => 8
    [2] => 27
    [3] => 64
    [4] => 125
)

    Exemple #2 array_map() utilisant une fonction quelconque

    <?php

    $func     = function(int $value): int {
    return     $value * 2;
    };

    print_r(array_map($func, range(1, 5)));

    // Ou à partir de PHP 7.4.0 :

    print_r(array_map(fn($value): int => $value * 2, range(1, 5)));

    ?>
    Array
(
    [0] => 2
    [1] => 4
    [2] => 6
    [3] => 8
    [4] => 10
)

    Exemple #3 array_map() : utilisation de plusieurs tableaux

    <?php
    function show_Spanish(int $n, string $m): string
    {
    return     "Le nombre {$n} se dit {$m} en Espagnol";
    }

    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);
    ?>

    L'exemple ci-dessus va afficher :

    // Contenu de $c
Array
(
    [0] => Le nombre 1 se dit uno en Espagnol
    [1] => Le nombre 2 se dit dos en Espagnol
    [2] => Le nombre 3 se dit tres en Espagnol
    [3] => Le nombre 4 se dit cuatro en Espagnol
    [4] => Le nombre 5 se dit cinco en Espagnol
)

// Contenu de $d
Array
(
    [0] => Array
        (
            [1] => uno
        )

    [1] => Array
        (
            [2] => dos
        )

    [2] => Array
        (
            [3] => tres
        )

    [3] => Array
        (
            [4] => cuatro
        )

    [4] => Array
        (
            [5] => cinco
        )

)

    Généralement, lors de l'utilisation de plusieurs tableaux, ils doivent être d'égale longueur, car la fonction de rappel est appliquée de manière similaire à tous les tableaux. Si les tableaux sont de tailles inégales, les plus petits seront complétés avec des éléments vides pour atteindre la taille du plus grand.

    Une utilisation intéressante de cette fonction est la construction de tableaux de tableaux, facilement réalisée en passant la valeur null comme nom de fonction de rappel.

    Exemple #4 Exécution d'une opération zip de tableaux

    <?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);
    ?>

    L'exemple ci-dessus va afficher :

    Array
(
    [0] => Array
        (
            [0] => 1
            [1] => one
            [2] => uno
        )

    [1] => Array
        (
            [0] => 2
            [1] => two
            [2] => dos
        )

    [2] => Array
        (
            [0] => 3
            [1] => three
            [2] => tres
        )

    [3] => Array
        (
            [0] => 4
            [1] => four
            [2] => cuatro
        )

    [4] => Array
        (
            [0] => 5
            [1] => five
            [2] => cinco
        )

)

    Exemple #5 null callback avec seulement array

    <?php
    $array     = [1, 2, 3];
    var_dump(array_map(null, $array));
    ?>

    L'exemple ci-dessus va afficher :

    array(3) {
  [0]=>
  int(1)
  [1]=>
  int(2)
  [2]=>
  int(3)
}

    Exemple #6 array_map() - avec des clés sous la forme de chaîne de caractères

    <?php
    $arr     = ['stringkey' => 'value'];
    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));
    ?>

    L'exemple ci-dessus va afficher :

    array(1) {
  ["stringkey"]=>
  array(1) {
    [0]=>
    string(5) "value"
  }
}
array(1) {
  [0]=>
  array(2) {
    [0]=>
    string(5) "value"
    [1]=>
    string(5) "value"
  }
}
array(1) {
  ["stringkey"]=>
  string(5) "value"
}
array(1) {
  [0]=>
  array(2) {
    [0]=>
    string(5) "value"
    [1]=>
    string(5) "value"
  }
}

    Exemple #7 array_map() - tableaux associatifs

    Même si array_map() ne supporte pas directement l'utilisation des clés d'un tableau comme entrée, ceci peut être simulé en utilisant array_keys().

    <?php
    $arr     = [
    'v1' => 'First release',
    'v2' => 'Second release',
    'v3' => 'Third release',
    ];
    // Note: Antérieur à 7.4.0, il faut utiliser la syntaxe plus longue pour les
    // fonctions anonymes à la place.
    $callback = fn(string $k, string $v): string => "$k was the $v";
    $result = array_map($callback, array_keys($arr), array_values($arr));
    var_dump($result);
    ?>

    L'exemple ci-dessus va afficher :

    array(3) {
  [0]=>
  string(24) "v1 was the First release"
  [1]=>
  string(25) "v2 was the Second release"
  [2]=>
  string(24) "v3 was the Third release"
}

    Voir aussi

    • array_filter() - Filtre les éléments d'un tableau grâce à une fonction de rappel
    • array_reduce() - Réduit itérativement un tableau
    • array_walk() - Exécute une fonction fournie par l'utilisateur sur chacun des éléments d'un tableau

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 8 notes

    up
    31
    lukasz dot mordawski at gmail dot com
    11 years ago
    Let's assume we have following situation:

    <?php
    class MyFilterClass {
    public function     filter(array $arr) {
    return     array_map(function($value) {
    return     $this->privateFilterMethod($value);
    });
    }

    private function     privateFilterMethod($value) {
    if (    is_numeric($value)) $value++;
    else     $value .= '.';
    }
    }
    ?>

    This will work, because $this inside anonymous function (unlike for example javascript) is the instance of MyFilterClass inside which we called it.
    I hope this would be useful for anyone.
    up
    20
    radist-hack at yandex dot ru
    16 years ago
    To transpose rectangular two-dimension array, use the following code:

    array_unshift($array, null);
    $array = call_user_func_array("array_map", $array);

    If you need to rotate rectangular two-dimension array on 90 degree, add the following line before or after (depending on the rotation direction you need) the code above:
    $array = array_reverse($array);

    Here is example:

    <?php
    $a     = array(
    array(    1, 2, 3),
    array(    4, 5, 6));
    array_unshift($a, null);
    $a = call_user_func_array("array_map", $a);
    print_r($a);
    ?>

    Output:

    Array
    (
    [0] => Array
    (
    [0] => 1
    [1] => 4
    )

    [1] => Array
    (
    [0] => 2
    [1] => 5
    )

    [2] => Array
    (
    [0] => 3
    [1] => 6
    )

    )
    up
    16
    Mahn
    9 years ago
    You may be looking for a method to extract values of a multidimensional array on a conditional basis (i.e. a mixture between array_map and array_filter) other than a for/foreach loop. If so, you can take advantage of the fact that 1) the callback method on array_map returns null if no explicit return value is specified (as with everything else) and 2) array_filter with no arguments removes falsy values.

    So for example, provided you have:

    <?php
    $data     = [
    [
    "name" => "John",
    "smoker" => false
    ],
    [
    "name" => "Mary",
    "smoker" => true
    ],
    [
    "name" => "Peter",
    "smoker" => false
    ],
    [
    "name" => "Tony",
    "smoker" => true
    ]
    ];
    ?>

    You can extract the names of all the non-smokers with the following one-liner:

    <?php
    $names     = array_filter(array_map(function($n) { if(!$n['smoker']) return $n['name']; }, $data));
    ?>

    It's not necessarily better than a for/foreach loop, but the occasional one-liner for trivial tasks can help keep your code cleaner.
    up
    3
    s dot kientzler at online dot de
    1 year ago
    If the callback function to be called is a static method from a different namespace, the fully qualified method including namespace must be specified (a use statement is not sufficient to resolve the namespace of the callback function)

    <?php
    use MyTools;

    $arr = [1, 2, 3];

    $arr = array_map('Tools::myHelper', $arr);
    ?>

    will cause TypeError:
    array_map() expects parameter 1 to be a valid callback, class 'Tools' not found.

    Use the fully qualified name for the callback instead:

    <?php
    $arr     = [1, 2, 3];

    $arr = array_map('\MyTools\Tools::myHelper', $arr);
    ?>
    up
    8
    CertaiN
    11 years ago
    The most memory-efficient array_map_recursive().

    <?php
    function array_map_recursive(callable $func, array $arr) {
    array_walk_recursive($arr, function(&$v) use ($func) {
    $v = $func($v);
    });
    return     $arr;
    }
    ?>
    up
    8
    stijnleenknegt at gmail dot com
    16 years ago
    If you want to pass an argument like ENT_QUOTES to htmlentities, you can do the follow.

    <?php
    $array     = array_map( 'htmlentities' , $array, array_fill(0 , count($array) , ENT_QUOTES) );
    ?>

    The third argument creates an equal sized array of $array filled with the parameter you want to give with your callback function.
    up
    2
    Walf
    2 years ago
    A general solution for the problem of wanting to know the keys in the callback, and/or retain the key association in the returned array:

    <?php

    /**
    * Like array_map() but callback also gets passed the current key as the
    * first argument like so:
    * function($key, $val, ...$vals) { ... }
    * ...and returned array always maintains key association, even if multiple
    * array arguments are passed.
    */

    function array_map_assoc(callable $callback, array $array, array ...$arrays) {
    $keys = array_keys($array);
    array_unshift($arrays, $keys, $array);
    return     array_combine($keys, array_map($callback, ...$arrays));
    }

    ?>

    Because it uses array_map() directly, it behaves the same way in regard to ignoring the keys of subsequent array arguments. It also has the same variadic signature.
    up
    1
    anonymous_user
    3 years ago
    /**
    * Function which recursively applies a callback to all values and also its
    * keys, and returns the resulting array copy with the updated keys and
    * values.
    * PHP's built-in function array_walk_recursive() only applies the passed
    * callback to the array values, not the keys, so this function simply applies
    * the callback to the keys too (hence the need of working with a copy,
    * as also updating the keys would lead to reference loss of the original
    * array). I needed something like this, hence my idea of sharing it here.
    *
    * @param callable $func callback which takes one parameter (value
    * or key to be updated) and returns its
    * updated value
    *
    * @param array $arr array of which keys and values shall be
    * get updated
    */

    function array_map_recursive(
    callable $func,
    array $arr
    ) {

    // Initiate copied array which will hold all updated keys + values
    $result = [];

    // Iterate through the key-value pairs of the array
    foreach ( $arr as $key => $value ) {

    // Apply the callback to the key to create the updated key value
    $updated_key = $func( $key );

    // If the iterated value is not an array, that means we have reached the
    // deepest array level for the iterated key, so in that case, assign
    // the updated value to the updated key value in the final output array
    if ( ! is_array( $value ) ) {

    $result[$updated_key] = $func( $value );

    } else {

    // If the iterated value is an array, call the function recursively,
    // By taking the currently iterated value as the $arr argument
    $result[$updated_key] = array_map_recursive(
    $func,
    $arr[$key]
    );

    }

    } // end of iteration through k-v pairs

    // And at the very end, return the generated result set
    return $result;

    } // end of array_map_recursive() function definition
    ＋add a note
    To Top