PHP 扩展 - 常用函数

字符串相关

void zend_str_tolower(char *str, size_t len);  // 转换字符串 char * 为小写
zend_string* zend_string_tolower(zend_string *str);  // 转换字符串 zend_string * 为小写
zend_string* php_string_tolower(zend_string *str);  // 功能跟上面一样，是 strtolower 的原型
zend_string* php_string_toupper(zend_string *str);  // strtoupper 的原型

// 格式化成 zend_string *, 使用完记得 zend_string_release
zend_string *strpprintf(size_t max_len, const char *format, ...);
// 格式化成 char *, 使用完记得 efree
size_t spprintf( char **pbuf, size_t max_len, const char *format, ...);

smart_str_*  // 待分析

zend_string *zval_get_string(zval *val);  // 从 zval 转换为 zend_string 并 COPY 一份

数组相关

uint32_t zend_hash_num_elements(HashTable *ht);  // 获取数组大小
zval* zend_hash_find(HashTable *ht, zend_string *key);  // 根据 zend_string * 作为 key 查找数组
zval* zend_hash_str_find(HashTable *ht, char *str, size_t len);  // 根据 char * 作为 key 查找数组
zval* zend_hash_index_find(HashTable *ht, zend_ulong h);  // 查找索引 h 的数组元素
void* zend_hash_find_ptr(HashTable *ht, zend_string *key);  // 同上，只是返回元素指针指向的值
void* zend_hash_str_find_ptr(HashTable *ht, char *str, size_t len);  // 跟上同类
void* zend_hash_index_find_ptr(HashTable *ht, zend_ulong h);  // 跟上同类
zend_bool zend_hash_exists(HashTable *ht, zend_string *key);  // zend_string * key 是否存在
zend_bool zend_hash_str_exists(HashTable *ht, char *str, size_t len);  // char * key 是否存在
zend_bool zend_hash_index_exists(HashTable *ht, zend_ulong h);  // 索引 h 是否存在

zend_array *HASH_OF(zval *val);  // 其实 HASH_OF 是一个宏，参数 value 可以是数组 `IS_ARRAY` 或者对象 `IS_OBJECT`，否则返回 NULL

方法和函数相关

zval* zend_call_method(zval *object_pp, zend_class_entry *obj_ce, zend_function **fn_proxy, const char *function_name, size_t function_name_len, zval *retval, int param_count, zval* arg1, zval* arg2);  // 调用类实例成员方法
zval* zend_call_method_with_0_params(zval *object_pp, zend_class_entry *obj_ce, zend_function **fn_proxy, const char *function_name, zval *retval);  // zend_call_method 的缩写，不传递参数
// 同类还有 zend_call_method_with_1_params 和 zend_call_method_with_2_params

输出

void php_var_dump(zval *struc, int level);  // 类似 var_dump 方法, 需要引入 ext/standard/php_var.h
size_t php_printf(const char *format, ...);  // 格式化输出到 PHP
size_t php_output_write(const char *str, size_t len);  // 等同于 PHPWRITE 宏