Forum und email
Matrices
PHP Manual

array_map

(PHP 4 >= 4.0.6, PHP 5)

array_map — Aplica la llamada de retorno especificada a los elementos de las matrices dadas

Descripción

array array_map ( callback $llamada_de_retorno , array $matriz1 [, array $... ] )

array_map() devuelve una matriz que contiene todos los elementos de matriz1 después de haber aplicado la función llamada_de_retorno a cada uno de ellos. El número de parámetros que la función llamada_de_retorno acepte debería coincidir con el número de matrices que son pasadas como argumentos a array_map().

Lista de parámetros

llamada_de_retorno

Función tipo llamada de retorno a ejecutar para cada elemento en cada matriz.

matriz1

Una matriz a recorrer con la función llamada_de_retorno .

matriz

Lista variable de argumentos tipo matriz a recorrer con la función llamada_de_retorno .

Valores retornados

Devuelve una matriz que contiene todos los elementos de matriz1 después de aplicar la función llamada_de_retorno a cada uno de ellos.

Ejemplos

Example#1 Ejemplo de array_map()

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

$a = array(1, 2, 3, 4, 5);
$b = array_map("cubo", $a);
print_r($b);
?>

Esto hace que $b contenga: 

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

Ejemplos

Example#2 array_map() - usando más matrices

<?php
function mostrar_castellano($n, $m)
{
    return("El número $n es llamado $m en castellano");
}

function map_castellano($n, $m)
{
    return(array($n => $m));
}

$a = array(1, 2, 3, 4, 5);
$b = array("uno", "dos", "tres", "cuatro", "cinco");

$c = array_map("mostrar_castellano", $a, $b);
print_r($c);

$d = array_map("map_castellano", $a , $b);
print_r($d);
?>

El resultado del ejemplo seria:

// salida correspondiente a $c
Array
(
    [0] => El número 1 es llamado uno en castellano
    [1] => El número 2 es llamado dos en castellano
    [2] => El número 3 es llamado tres en castellano
    [3] => El número 4 es llamado cuatro en castellano
    [4] => El número 5 es llamado cinco en castellano
)

// salida correspondiente a $d
Array
(
    [0] => Array
        (
            [1] => uno
        )

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

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

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

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

)

Usualmente, cuando se usan dos o más matrices, éstas deberían ser de longitudes iguales ya que la llamada de retorno es aplicada en paralelo a los elementos correspondientes. Si las matrices son de longitudes diferentes, la más corta de ellas será extendida con elementos vacíos.

Un uso interesante de esta función es la construcción de una matriz de matrices, que puede ser llevada a cabo usando NULL como el nombre de la llamada de retorno.

Example#3 Creación de una matriz de matrices

<?php
$a = array(1, 2, 3, 4, 5);
$b = array("one", "two", "three", "four", "five");
$c = array("uno", "dos", "tres", "cuatro", "cinco");

$d = array_map(null, $a, $b, $c);
print_r($d);
?>

El resultado del ejemplo seria:

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
        )

)

Ver también

information about the callback type

Matrices
PHP Manual