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