array_map

array_map(PHP 4.0.6, PHP 5)

指定した配列の要素にコールバック関数を適用します。

形式

array_map ( $callback , $arr1 [, $arr2 ... ] )

パラメータ

引数説明
$callback配列の各要素に適用するコールバック関数
$arr1コールバック関数を適用する配列($callbackの第1引数)
$arr2 ...コールバック関数に渡す引数を指定する配列の可変リスト($callbackの第2引数~)

返り値

$arr1 の各要素に $callback 関数を適用した後、その全ての要素を含む配列を返します。

サンプル

function cube($n) {
	return($n * $n * $n);
}

$a = array(1, 2, 3, 4, 5);
$b = array_map("cube", $a);
print_r($b);
Array
(
   [0] => 1
   [1] => 8
   [2] => 27
   [3] => 64
   [4] => 125
)

メモ

通常、2つ以上の配列を使用する場合、それらの長さは等しい必要があります。

これは、コールバック関数が対応する要素に対して並行して適用されるためです。

配列の長さが等しくない場合、最も短い配列は空の要素で拡張されます。