função array_map() do PHP

exemplo

Aplica a função a cada valor do array, multiplicando cada valor por si mesmo e retornando um array com novos valores:

<?php
function myfunction($v)
{
  return($v*$v);
}
$a = array(1, 2, 3, 4, 5);
print_r(array_map("myfunction",$a));
?>

Executar exemplo

definição e uso

A função array_map() aplica a função personalizada do usuário a cada valor do array, retornando um array com novos valores.

O número de parâmetros aceitos pela função de callback deve coincidir com o número de arrays passados para a função array_map().

dica:Você pode passar um ou mais arrays para a função.

sintaxe

array_map(myfunction,array1,array2,array3...)
parâmetros descrição
myfunction obrigatório. O nome da função personalizada do usuário, ou null.
array1 obrigatório. Especifica um array.
array2 opcional. Especifica um array.
array3 opcional. Especifica um array.

detalhes técnicos

valor de retorno: retorna um contendo array1 do array dos valores, após aplicar a função personalizada a cada valor.
Versão PHP: 4.0.6+

Mais exemplos

Exemplo 1

Usar função personalizada para alterar o valor do array:

<?php
function myfunction($v)
{
if ($v==="Dog")
  {
  return "Fido";
  }
return $v;
}
$a=array("Horse","Dog","Cat");
print_r(array_map("myfunction",$a));
?>

Executar exemplo

Exemplo 2

Usar dois arrays:

<?php
function myfunction($v1,$v2)
{
if ($v1===$v2)
  {
  return "same";
  }
return "different";
}
$a1=array("Horse","Dog","Cat");
$a2=array("Cow","Dog","Rat");
print_r(array_map("myfunction",$a1,$a2));
?>

Executar exemplo

Exemplo 3

Transformar todas as letras do valor do array em maiúsculas:

<?php
function myfunction($v)
{
$v=strtoupper($v);
  return $v;
}
$a=array("Animal" => "horse", "Type" => "mammal");
print_r(array_map("myfunction",$a));
?>

Executar exemplo

Exemplo 4

Quando atribui o nome da função a null:

<?php
$a1=array("Dog","Cat");
$a2=array("Puppy","Kitten");
print_r(array_map(null,$a1,$a2));
?>

Executar exemplo