Função PHP array_map()

Exemplo

Aplique a função a cada valor do array, multiplique cada valor por si mesmo e retorne o array com o novo valor:

<?phpfunction minhafunção($v){ return($v*$v);}$a=array(1,2,3,4,5);print_r(array_map("minhafunção",$a));?>

Definição e uso

A função array_map() aplica a função definida pelo usuário a cada valor do array e retorna o array com os novos valores após a aplicação da função definida pelo usuário.

Dica: Você pode inserir um ou mais arrays na função.

gramática

 array_map( minhafunção, array1, array2, array3 ...)

parâmetro	descrever
minha função	Obrigatório. O nome da função definida pelo usuário ou nulo.
matriz1	Obrigatório. Especifica uma matriz.
matriz2	Opcional. Especifica uma matriz.
matriz3	Opcional. Especifica uma matriz.

detalhes técnicos

Valor de retorno:	Retorna uma matriz contendo o valor de array1 após a aplicação da função definida pelo usuário.
Versão PHP:	4.0.6+

Mais exemplos

Exemplo 1

Use uma função definida pelo usuário para alterar o valor de um array:

<?phpfunction minhafunção($v){if ($v==="Cão") { return "Fido";}$a=array("Cavalo","Cão","Gato"); print_r(array_map("minhafunção",$a));?>

Exemplo 2

Use duas matrizes:

<?phpfunction minhafunção($v1,$v2){if ($v1===$v2) { return "mesmo"; return "diferente";}$a1=array("Cavalo","Cão","Gato ");$a2=array("Vaca","Cão","Rato");print_r(array_map("minhafunção",$a1,$a2));?>

Exemplo 3

Altere todas as letras dos valores de uma matriz para maiúsculas:

<?phpfunction minhafunção($v) {$v=strtoupper($v); return $v;}$a=array("Animal" => "cavalo", "Tipo" => "mamífero");print_r(array_map ("minhafunção",$a));?>

Exemplo 4

Ao atribuir o nome da função a null:

<?php$a1=array("Cão","Gato");$a2=array("Cachorro","Gatinho");print_r(array_map(null,$a1,$a2));?>