Variables
void zval_add_ref(zval **ppzval);
Increases the refcount of ppzval. This function is identical to the command: (*ppzval)->refcount++; Like the other accessor functions and macros, its use is encouraged over direct access of the zvals in order to ensure maximum forward compatibility.
void zval_copy_ctor(zval *zvalue);
Duplicates all of a zval's internal structures. This command typically follows copying one zval's contents into another. Refer to Chapter 8 for a detailed use of this API call.
void zval_ptr_dtor(zval **zval_ptr);
Decreases a zval's refcount by one. If the refcount reaches zero, the internal structures of the zval are destroyed by automatically calling through to zval_dtor(*zval_ptr);.
After the internal structures are destroyed, efree(*zval_ptr); is called to destroy the zval container as well.
void zval_dtor(zval *zvalue);
Frees all of a zval's associated internal structures regardless of refcount. For example, an IS_STRING variable would have efree(Z_STRVAL_P(zvalue)); called.
char *zend_zval_type_name(zval *arg);
Translates a zval's numeric type identifier into a human readable name. For example, if arg is an IS_LONG zval, this function will return "integer".
int zend_is_true(zval *arg);
Tests the passed arg for truthness. As in, if this variable were used in a userspace conditional statement, would it yield a net result of trUE or FALSE? False values may occur from IS_NULL variables as well as literal Boolean FALSE values, or numeric values of 0 or 0.0. Empty strings, empty arrays, and a few specially designed objects can also result in a net-false value.
int zend_register_auto_global(char *name, uint name_len, zend_auto_global_callback callback TSRMLS_DC);
Register an auto (super) global variable. Any variable named here will automatically resolve itself to the global scope as if it were accessed as $GLOBALS['name'].
Argument |
Purpose |
---|---|
name |
NULL-terminated, case-sensitive variable name to be autogloballed. |
name_len |
Length of name excluding the trailing NULL. |
callback |
Compiler hook to execute additional code when an autoglobal variable is used in a compiled script. Refer to Chapter 12 for more information. |