array_reduce
(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
array_reduce — 用回撥函式迭代地將陣列簡化為單一的值
說明
   array_reduce() 將回調函式
   callback 迭代地作用到
   array 陣列中的每一個單元中,從而將陣列簡化為單一的值。
     
參數
- 
array
- 
      輸入的 array。 
- 
callback
- 
      
    - 
carry
- 
      攜帶上次迭代的返回值; 如果本次迭代是第一次,那麼這個值是 initial。
- 
item
- 
         攜帶了本次迭代的值。 
 
- 
- 
initial
- 
      如果指定了可選參數 initial,該參數將用作處理開始時的初始值,如果陣列為空,則會作為最終結果返回。
返回值
返回結果值。
   如果陣列為空,並且沒有指定
   initial 參數,array_reduce() 返回 null。
  
更新日誌
| 版本 | 說明 | 
|---|---|
| 8.0.0 | 如果 callback接受引用傳遞參數,該方法將會拋出E_WARNING。 | 
範例
示例 #1 array_reduce() 例子
<?php
function sum($carry, $item)
{
    $carry += $item;
    return $carry;
}
function product($carry, $item)
{
    $carry *= $item;
    return $carry;
}
$a = array(1, 2, 3, 4, 5);
$x = array();
var_dump(array_reduce($a, "sum")); // int(15)
var_dump(array_reduce($a, "product", 10)); // int(1200), 因為:10*1*2*3*4*5
var_dump(array_reduce($x, "sum", "No data to reduce")); // string(17) "No data to reduce"
?>
參見
- array_filter() - 使用回撥函式過濾陣列的元素
- array_map() - 為陣列的每個元素應用回撥函式
- array_unique() - 移除陣列中重複的值
- array_count_values() - 統計陣列中所有的值