array_map

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

array_map — Aplica una función sobre los elementos de un array

Descripción

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

array_map() devuelve un array que contiene los resultados de la aplicación de la función de devolución de llamada callback al valor correspondiente de array (y arrays si se proporcionan más arrays) utilizados como argumentos para la función de devolución de llamada. El número de argumentos que la función de devolución de llamada callback acepta debe corresponder al número de arrays pasados a array_map(). Los arrays de entrada adicionales son ignorados. Se lanza una ArgumentCountError si se proporciona un número insuficiente de argumentos.

Parámetros

callback

La función de devolución de llamada de tipo callable a ejecutar para cada elemento de cada array.

null puede ser pasado como valor a callback para ejecutar una operación zip sobre varios arrays y devolver un array donde cada elemento es un array que contiene los elementos de los arrays de entrada en la misma posición del puntero interno del array (ver ejemplo a continuación). Si solo array es proporcionado, array_map() devolverá el array de entrada.

array

Un array a ejecutar a través de la función de devolución de llamada callback.

arrays

Lista variable de argumentos de arrays adicionales a ejecutar a través de la función de devolución de llamada callback.

Valores devueltos

Devuelve un array que contiene los resultados de la aplicación de la función de devolución de llamada callback al valor correspondiente de array (y arrays si se proporcionan más arrays) utilizados como argumentos para la función de devolución de llamada.

El array devuelto conservará las claves del array pasado como argumento, si y solo si, se pasa un solo array. Si se pasan varios arrays como argumento, el array devuelto tendrá claves secuenciales en forma de entero.

Historial de cambios

Versión	Descripción
8.0.0	Si `callback` espera un parámetro a ser pasado por referencia, esta función emite ahora una `E_WARNING`.

Ejemplos

Ejemplo #1 Ejemplo con array_map()

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

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

El contenido de la variable $b será:

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

Ejemplo #2 array_map() utilizando una función cualquiera

<?php

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

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

// O a partir de PHP 7.4.0:

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

?>

El ejemplo anterior mostrará:

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

Ejemplo #3 array_map(): uso de varios arrays

<?php
function show_Spanish(int $n, string $m): string
{
    return "El número {$n} se dice {$m} en Español";
}

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

El ejemplo anterior mostrará:

// Contenido de $c
Array
(
    [0] => El número 1 se dice uno en Español
    [1] => El número 2 se dice dos en Español
    [2] => El número 3 se dice tres en Español
    [3] => El número 4 se dice cuatro en Español
    [4] => El número 5 se dice cinco en Español
)

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

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

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

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

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

)

Generalmente, al utilizar varios arrays, estos deben tener la misma longitud, ya que la función de devolución de llamada se aplica de manera similar a todos los arrays. Si los arrays tienen longitudes desiguales, los más pequeños serán completados con elementos vacíos para alcanzar la longitud del más grande.

Un uso interesante de esta función es la construcción de arrays de arrays, fácilmente realizada pasando el valor null como nombre de función de devolución de llamada.

Ejemplo #4 Ejecutar una operación zip de arrays

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

El ejemplo anterior mostrará:

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
        )

)

Ejemplo #5 null callback con solo array

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

El ejemplo anterior mostrará:

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

Ejemplo #6 array_map() - con claves en forma de string

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

El ejemplo anterior mostrará:

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"
  }
}

Ejemplo #7 array_map() - arrays asociativos

Aunque array_map() no soporta directamente el uso de las claves de un array como entrada, esto puede ser simulado utilizando array_keys().

<?php
$arr = [
    'v1' => 'First release',
    'v2' => 'Second release',
    'v3' => 'Third release',
];
// Nota: Anterior a 7.4.0, se debe utilizar la sintaxis más larga para las
// funciones anónimas en su lugar.
$callback = fn(string $k, string $v): string => "$k was the $v";
$result = array_map($callback, array_keys($arr), array_values($arr));
var_dump($result);
?>

El ejemplo anterior mostrará:

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"
}

Ver también

array_filter() - Filtra los elementos de un array mediante una función de retrollamada
array_reduce() - Reduce itérativemente un array
array_walk() - Ejecuta una función proporcionada por el usuario en cada uno de los elementos de un array

Found A Problem?

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

＋add a note

User Contributed Notes 9 notes

down

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.

down

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
        )

)

down

s dot kientzler at online dot de ¶

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

down

CertaiN ¶

12 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;
}
?>

down

Mahn ¶

10 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.

down

stijnleenknegt at gmail dot com ¶

17 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.

down

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

down

Walf ¶

3 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.

down

-1

filipefigueiraf at gmail dot com ¶

3 months ago

<?php 

function highAndLow(string $numbers): string {

    // Split the input string into an array using spaces as delimiter
    // Then filter out any non-numeric values
    $numbers = array_filter(explode(" ", $numbers), 'is_numeric');

    // Convert the remaining numeric strings to integers
    $ints = array_map('intval', $numbers);

    // Return the highest and lowest numbers, separated by a space
    return max($ints) . " " . min($ints);
}

// Example usage: will output "388 2"
echo(highAndLow(' 2 388  asdfgh 4'));

?>

＋add a note