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