### 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; }