php zend_parse_parameters有什么作用,PHP内核探索：zend_parse_parameters函数

最简单的获取函数调用者传递过来的参数便是使用zend_parse_parameters()函数。

zend_parse_parameters()函数的前几个参数我们直接用内核里宏来生成便可以了，形式为：ZEND_NUM_ARGS() TSRMLS_CC，注意两者之间有个空格，但是没有逗号。

从名字可以看出，ZEND_NUM_ARGS()代表这参数的个数。

紧接着需要传递个zend_parse_parameters()函数的参数是一个用于格式化的字符串，就像printf的第一个参数一样。下面表示了最常用的几个符号。

参数   代表着的类型

bBoolean

lInteger 整型

dFloating point 浮点型

sString 字符串

rResource 资源

aArray 数组

oObject instance 对象

OObject instance of a specified type 特定类型的对象

zNon-specific zval 任意类型～

Zzval**类型

f表示函数、方法名称，PHP5.1里貌似木有... ...

这个函数就像printf()函数一样，后面的参数是与格式化字符串里的格式一一对应的。

示例：【蓝色代码[php]和红色代码[php扩展函数]效果是一样的】

function sample_hello_world($name)

{

echo "Hello $name!\n";

}

?>

ZEND_FUNCTION(sample_getlong)

{

long foo;

if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC,"l", &foo) == FAILURE)

{

RETURN_NULL();

}

php_printf("The integer value of the parameter is: %ld\n", foo);

RETURN_TRUE;

}

除了上面定义的参数，还有其它的三个参数来增强我们接受参数的能力，如下：

类型修饰符     含义

|            它之前的参数都是必须的，之后的都是非必须的，也就是有默认值的。

!            如果接收了一个PHP语言里的null变量，则直接把其转成C语言里的NULL，而不是封装成IS_NULL类型的zval。

/            如果传递过来的变量与别的变量共用一个zval，而且不是引用，则进行强制分离，新的zval的is_ref__gc==0, and refcount__gc==1.

zend_parse_parameters中的(l)参数，这个参数之前的参数被认为是必须的，之后的便认为是非必须的了,如果没有传递，则不会去修改载体。

下面对修饰符：l 进行分析：

看如下php代码：

function hello_name($name , $greeting='Mr./Mrs.')

{

echo "Hello $greeting $name ! \n";

}

hello_name ('Jim','Mrs.');

hello_name('Jon'); //默认使用给greeting指定的值

?>

运行输出：Hello Mrs. Jim ！

Hello Mr./Mrs. Jon !

在扩展函数里可以实现同样的功能，代码如下：

ZEND_FUNCTION(hello_name2)

{

char *name, *greeting='Mr./Mrs.';

int name_len, greeting_len=sizeof("Mr./Mrs.")-1;

if(zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|s", &name, &name_len, &greeting, &greeting_len) == FAILURE)

{

RETURN_STRING("succe！",1);

}

php_printf("Hello ");

PHPWRITE(greeting, greeting_len);

php_printf("   ");

PHPWRITE(name ,name_len);

php_printf("! \n");

}

延伸阅读

此文章所在专题列表如下：