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

這篇文章主要介紹了關於淺談PHP源碼十五：關於array_walk函數 ，有著一定的參考價值，現在分享給大家，有需要的朋友可以參考一下

淺談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：

   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中文網其他相關文章！