nginx开发:ngx_sprintf

格式化参数%系列,如果误用的话,轻则输出不正确,重则nginx可能core。

1. 格式:

    %{格式描述}{输出类型描述}{数据类型描述}

2. 数据类型描述:

    V:字符串,对应ngx_str_t *(注意是指针)

    v:变量值,对应ngx_variable_value_t *(也是指针)

    s:可定长字符串,对应uchar *(不使用定长功能的话,等价于标准C的s)

    O:偏移量,对应off_t

    P:进程ID,对应ngx_pid_t

    T:时间,对应time_t

    M:毫秒计时,对应ngx_msec_t

    z:容量,对应ssize_t或size_t

    i:nginx整数,对应ngx_int_t

    d:系统整数,对应int

    l:系统长整数,对应long

    D:32位整数,对应int32_t或uint32_t

    L:64位长整数,对应int64_t或uint64_t

    A:原子整数,对应ngx_atomic_int_t或ngx_atomic_uint_t

    f:浮点数,对应double,但是如果传入的参数是float,也会被C升级为double。

    p:指针,对应void *

    c:字符,对应int,但是如果传入的参数是char,也会被C升级为int。

    Z:字符串尾0

    N:换行

    %:%

这里之所谓强调类型描述符,是因为这个类型在不同的系统下定义的长度不一(32位和64位系统),如果乱用,会导致移植性差。

3. 输出类型描述符

    u:无符号数值

    m:指定按数据类型的最大值所占宽度输出数字

    x:小写16进制

    X:大写16进制

    .:后面的数字表示小数位数

    *:指定输出字符串直至字符长度限制

这里需要说明的是输出类型描述符无法单独使用,必须与数据类型描述符一同使用,这和标准C是可能不一样的。

4.  格式描述

    描述输出的宽度和填充内容,填充内容以%后第一个数字而定,‘0’代表以‘0’填出,其他内容则使用默认的‘ ’填充。宽度描述则是填充设定以后的数字。整个格式描述类似于021、2等等。

5.  整体举例

    %5.2f:宽度5,小数位数2,输出double 

    %*s:限定长度输出字符串,数据定义需要两个参数,length和ptr

    % 010ud,宽度10,以0补齐,输出unsigned int(新浪博客吃字符,所以在%和0之间加了空格,实际没有的)

    % 10ui, 宽度10,以空格补齐,输出ngx_uint_t(同上) 

ngx_sprintf()

函数用来拼字符串。
第一个参数传buffer地址,可以通过直接加指针值的方法,传某个原有字符串中间的地址,达到灵活修改字符串的目的;
第二个参数传格式,是nginx自定义的格式,因为它封装了字符串嘛,不得不自定义。最常用的是%V,代表ngx_str_t;
后面的变长参数就是传变量了,记得ngx_str_t要传指针。

猜你喜欢

转载自www.cnblogs.com/hookjc/p/13178563.html