时间:2021-07-01 10:21:17 帮助过:27人阅读
写好迭代回调函数,有两种回调格式:
// 传值int callback(zval *val) { zvaltmp; // 增加一个临时 zval 避免 convert_to_string 污染原元素 ZVAL_COPY(&tmp, val); // 复制 val 的值,在 PHP5 中,需要用 zval_copy_ctor 并重置引用计数,现在貌似不用了 convert_to_string(&tmp); // 字符串类型转换 // 目的很简单,只是打印出来 php_printf("The value is: [ "); PHPWRITE(Z_STRVAL(tmp), Z_STRLEN(tmp)); php_printf(" ]"); zval_dtor(&tmp); // 主动释放临时 zval,不然会内存泄漏 return ZEND_HASH_APPLY_KEEP;} // 传键和值int callback_args(zval *val, int num_args, va_listargs, zend_hash_key *hash_key) { zvaltmp = *val; ZVAL_COPY(&tmp, val); convert_to_string(&tmp); // 打印键值对结果 php_printf("The key is : [ "); if (hash_key->key) { PHPWRITE(ZSTR_VAL(hash_key->key), ZSTR_LEN(hash_key->key)); } else { php_printf("%ld", hash_key->h); } php_printf(" ], the value is: [ "); PHPWRITE(Z_STRVAL(tmp), Z_STRLEN(tmp)); php_printf(" ]"); zval_dtor(&tmp); return ZEND_HASH_APPLY_KEEP;}
zval *val是数组里面元素的值 zval, hash_key是元素的键,它们都是指针,其中 zend_hash_key的结构定义在 zend_hash.h 中
typedef struct _zend_hash_key { zend_ulong h; // 数字键 zend_string *key; // 字符串键} zend_hash_key;
回调函数可返回三种常量值:
常量 | 描述 |
---|---|
ZEND_HASH_APPLY_KEEP | 返回这个值将完成当前循环,并继续迭代 HashTable 中的下一个值,这等价于在foreach()控制块中执行 continue; |
ZEND_HASH_APPLY_STOP | 返回这个值将中断迭代,等价于在 foreach() 控制块中执行 break; |
ZEND_HASH_APPLY_REMOVE | 类似于 ZEND_HASH_APPLY_KEEP,这个返回值将跳到下⼀次迭代,不过这个返回值同时会导致从原 HashTable 中删除当前元素 |
假设我们定义了一个 PHP 函数 foo:
PHP_FUNCTION(foo){ // 从参数中获取 arr zval *arr; if (zend_parse_parameters(ZEND_NUM_ARGS(), "a", &arr) == FAILURE) { RETURN_NULL(); } // 遍历值 zend_hash_apply(ZARRVAL_P(arr), callback); // 遍历键和值 zend_hash_apply_with_arguments(Z_ARRVAL_P(arr), callback_args, 0);}
Z_ARRVAL_P用户返回 zval 结构中的 value.arr 指针