7.6.4 函数返回值

最后更新于:2022-04-02 05:18:42

### 7.6.4 函数返回值 调用内部函数时其返回值指针作为参数传入,这个参数为`zval *return_value`,如果函数有返回值直接设置此指针即可,需要特别注意的是设置返回值时需要增加其引用计数,举个例子来看: ```c PHP_FUNCTION(my_func_1) { zval *arr; if(zend_parse_parameters(ZEND_NUM_ARGS(), "a", &arr) == FAILURE){ RETURN_FALSE; } //增加引用计数 Z_ADDREF_P(arr); //设置返回值为数组: ZVAL_ARR(return_value, Z_ARR_P(arr)); } ``` 此函数接收一个数组,然后直接返回该数组,相当于: ```php function my_func_1($arr){ return $arr; } ``` 调用该函数: ```php $a = array(); //$a -> zend_array(refcount:1) $b = my_func_1($a); //传参后:参数arr -> zend_array(refcount:2) //然后函数内部赋给了返回值:$b,$a,arr -> zend_array(refcount:3) //函数return阶段释放了参数:$b,$a -> zend_array(refcount:2) var_dump($b); =============[output]=========== array(0) { } ``` 虽然可以直接设置return_value,但实际使用时并不建议这么做,因为PHP提供了很多专门用于设置返回值的宏,这些宏定义在`zend_API.h`中: ```c //返回布尔型,b:IS_FALSE、IS_TRUE #define RETURN_BOOL(b) { RETVAL_BOOL(b); return; } //返回NULL #define RETURN_NULL() { RETVAL_NULL(); return;} //返回整形,l类型:zend_long #define RETURN_LONG(l) { RETVAL_LONG(l); return; } //返回浮点值,d类型:double #define RETURN_DOUBLE(d) { RETVAL_DOUBLE(d); return; } //返回字符串,可返回内部字符串,s类型为:zend_string * #define RETURN_STR(s) { RETVAL_STR(s); return; } //返回内部字符串,这种变量将不会被回收,s类型为:zend_string * #define RETURN_INTERNED_STR(s) { RETVAL_INTERNED_STR(s); return; } //返回普通字符串,非内部字符串,s类型为:zend_string * #define RETURN_NEW_STR(s) { RETVAL_NEW_STR(s); return; } //拷贝字符串用于返回,这个会自己加引用计数,s类型为:zend_string * #define RETURN_STR_COPY(s) { RETVAL_STR_COPY(s); return; } //返回char *类型的字符串,s类型为char * #define RETURN_STRING(s) { RETVAL_STRING(s); return; } //返回char *类型的字符串,s类型为char *,l为字符串长度,类型为size_t #define RETURN_STRINGL(s, l) { RETVAL_STRINGL(s, l); return; } //返回空字符串 #define RETURN_EMPTY_STRING() { RETVAL_EMPTY_STRING(); return; } //返回资源,r类型:zend_resource * #define RETURN_RES(r) { RETVAL_RES(r); return; } //返回数组,r类型:zend_array * #define RETURN_ARR(r) { RETVAL_ARR(r); return; } //返回对象,r类型:zend_object * #define RETURN_OBJ(r) { RETVAL_OBJ(r); return; } //返回zval #define RETURN_ZVAL(zv, copy, dtor) { RETVAL_ZVAL(zv, copy, dtor); return; } //返回false #define RETURN_FALSE { RETVAL_FALSE; return; } //返回true #define RETURN_TRUE { RETVAL_TRUE; return; }
';