# PHP array_walk() 函數 ## 定義和用法 array_walk() 函數對數組中的每個元素應用回調函數。如果成功則返回 TRUE，否則返回 FALSE。 典型情況下 _function_ 接受兩個參數。_array_ 參數的值作為第一個，鍵名作為第二個。如果提供了可選參數 _userdata_ ，將被作為第三個參數傳遞給回調函數。 如果 _function_ 函數需要的參數比給出的多，則每次 array_walk() 調用 _function_ 時都會產生一個 E_WARNING 級的錯誤。這些警告可以通過在 array_walk() 調用前加上 PHP 的錯誤操作符 @ 來抑制，或者用 [error_reporting()](/php/func_error_reporting.asp "PHP error_reporting() 函數")。 ### 語法 ``` array_walk(array,function,userdata...) ``` | 參數 | 描述 | | --- | --- | | array | 必需。規定數組。 | | function | 必需。用戶自定義函數的名稱。 | | userdata | 可選。用戶輸入的值，可作為回調函數的參數。 | ## 提示和注釋 提示：您可以為函數設置一個或多個參數。 注釋：如果回調函數需要直接作用于數組中的值，可以將回調函數的第一個參數指定為引用：&$value。（參見例子 3） 注釋：將鍵名和 userdata 傳遞到 function 中是 PHP 4.0 新增加的。 ## 例子 1 ``` <?php function myfunction($value,$key) { echo "The key $key has the value $value<br />"; } $a=array("a"=>"Cat","b"=>"Dog","c"=>"Horse"); array_walk($a,"myfunction"); ?> ``` 輸出： ``` The key a has the value Cat The key b has the value Dog The key c has the value Horse ``` ## 例子 2 帶有一個參數： ``` <?php function myfunction($value,$key,$p) { echo "$key $p $value<br />"; } $a=array("a"=>"Cat","b"=>"Dog","c"=>"Horse"); array_walk($a,"myfunction","has the value"); ?> ``` 輸出： ``` a has the value Cat b has the value Dog c has the value Horse ``` ## 例子 3 改變數組元素的值（請注意 &$value）： ``` <?php function myfunction(&$value,$key) { $value="Bird; } $a=array("a"=>"Cat","b"=>"Dog","c"=>"Horse"); array_walk($a,"myfunction"); print_r($a); ?> ``` 輸出： ``` Array ( [a] => Bird [b] => Bird [c] => Bird ) ```