淺談PHP源碼十五：關于array_walk函數

array_walk

(PHP 3 = 3.0.3, PHP 4, PHP 5)
array_walk — 對數組中的每個成員應用用戶函數
說明

bool array_walk ( array array, callback funcname [, mixed userdata] )

如果成功則返回 TRUE，失敗則返回 FALSE。
將用戶自定義函數 funcname 應用到 array 數組中的每個單元。典型情況下 funcname 接受兩個參數。array 參數的值作為第一個，鍵名作為第二個。如果提供了可選參數 userdata，將被作為第三個參數傳遞給 callback funcname。
如果 funcname 函數需要的參數比給出的多，則每次 array_walk() 調用 funcname 時都會產生一個 E_WARNING 級的錯誤。這些警告可以通過在 array_walk() 調用前加上 PHP 的錯誤操作符 @ 來抑制，或者用 error_reporting()。
注意: 如果 funcname 需要直接作用于數組中的值，則給 funcname 的第一個參數指定為引用。這樣任何對這些單元的 改變也將會改變原始數組本身。
注意: 將鍵名和 userdata 傳遞到 funcname 中是 PHP 4.0 新增加的。

array_walk() 不會受到 array 內部數組指針的影響。array_walk() 會遍歷整個數組而不管指針的位置。(這是由于程序在數組遍歷開始時就重置了數組所在hash table的指針)
用戶不應在回調函數中改變該數組本身。例如增加/刪除單元，unset 單元等等。如果 array_walk() 作用的數組改變了，則此函數的的行為未經定義，且不可預期。
程序實現說明：
擴展最后調用的是函數php_array_walk：

 html' target='_blank'>static int php_array_walk(HashTable *target_hash, zval **userdata, int recursive TSRMLS_DC)

當recursive == 0時，此函數為array_walk函數實現

當recursive == 1時，此函數為array_walk_recursive函數的實現

源碼中，程序會遍歷整個數組，并針對每個數組元素，根據傳入的函數，作相關的函數調用
函數的調用如下：

fci.size = sizeof(fci); fci.function_table = EG(function_table); fci.function_name = *BG(array_walk_func_name); fci.symbol_table = NULL; fci.object_pp = NULL; fci.retval_ptr_ptr = retval_ptr; fci.param_count = userdata ? 3 : 2; fci.params = args; fci.no_separation = 0; /* Call the userland function */ if (zend_call_function( fci, array_walk_fci_cache TSRMLS_CC) == SUCCESS) {

在此函數調用中有使用到一個結構體，個人添加的注釋如下：

 typedef struct _zend_fcall_info { size_t size; // 整個結構體的長度，等于sizeof(此函數體的變量) HashTable *function_table; // executor_globals.function_table zval *function_name; // 函數名  HashTable *symbol_table; zval **retval_ptr_ptr; // 函數的返回值 zend_uint param_count; // 參數個數 zval ***params; // 所調用函數的參數 zval **object_pp; // 用于對象的方法調用時，存儲對象 zend_bool no_separation; // 是否清空參數所在的棧} zend_fcall_info;

以上為個人所注，如有錯，請指正！

EOF

以上就是本文的全部內容，希望對大家的學習有所幫助，更多相關內容請關注PHP ！

相關推薦：

淺談PHP源碼十四： 關于array_combine函數

淺談PHP源碼十三：關于array_change_key_case，array_chunk的介紹

淺談PHP源碼十二：關于return_value 返回值

以上就是淺談PHP源碼十五：關于array_walk函數的詳細內容，PHP教程

鄭重聲明：本文版權歸原作者所有，轉載文章僅為傳播更多信息之目的，如作者信息標記有誤，請第一時間聯系我們修改或刪除，多謝。