zend_read_property函数中rv参数的作用是什么？

我正在使用zend_read_property函数读取对象的属性，函数定义如下：

zend_read_property(
    scope: *mut zend_class_entry, 
    object: *mut zval, 
    name: *const c_char, 
    name_length: size_t, 
    silent: zend_bool, 
    rv: *mut zval
) -> *mut zval

我的调用代码如下：

zval *output, rv;

output = zend_read_property(ce, Z_OBJ_P(ZEND_THIS), ZEND_STRL("output"), ZEND_FETCH_CLASS_SILENT, &rv);

但我不清楚为何需要rv参数，请问该参数的用途是什么？

rv参数的核心作用 #

rv是由调用者提供的临时zval缓冲区，主要用于两种场景：

• 存储属性不存在时的默认值：当目标属性不存在，且silent未开启静默模式时，函数会生成UNDEF类型的默认zval并写入rv，同时返回指向rv的指针。
• 统一内存管理：在部分属性读取逻辑中，函数需要临时创建zval承载返回值，rv提供了可控的内存空间，让调用者负责这个zval的生命周期（比如后续用zval_ptr_dtor清理），避免内部临时对象引发的内存泄漏。

调用注意事项 #

• 必须确保传入的rv是已初始化的有效zval（可提前用ZVAL_UNDEF(&rv)初始化），否则可能触发内存错误。
• 若函数返回的指针等于&rv，说明返回的是临时值，需妥善处理其内存；若返回对象内部的属性zval指针，则无需额外清理rv，但rv本身仍需按规则销毁。

内容的提问来源于stack exchange，提问作者Mark Smith