nginx数据结构（ngx_str_t）

字符串数据结构：

typedef struct {
    size_t      len;
    u_char     *data;
} ngx_str_t;

/*通过一个以’\0’结尾的普通字符串str构造一个nginx的字符串，
鉴于其中采用sizeof操作符计算字符串长度，因此参数必须是一个常量字符串。*/
#define ngx_string(str) {sizeof(str)-1,(u_char *) str}

/*使用ngx_null_string初始化字符串为空字符串*/
#define ngx_null_string     { 0, NULL } 

/*设置字符串str为text，text必须为常量字符串*/
#define ngx_str_set(str, text)                                 \
    (str)->len = sizeof(text) - 1; (str)->data = (u_char *) text

/*设置str为空串*/
#define ngx_str_null(str)   (str)->len = 0; (str)->data = NULL


/***ngx_str_t的赋值、初始化***/
ngx_str_t str = ngx_string("hello world");   //right
ngx_str_t str1 = ngx_null_string;            //right
ngx_str_t str, str1;
str = ngx_string("hello world");             // 编译出错,在c中结构体中涉及到指针时，是不允许直接赋值的
str1 = ngx_null_string;                      // 编译出错
ngx_str_set(&str, "hello world");            //right
ngx_str_null(&str1);                         //right
str  = (ngx_str_t) ngx_string("hello world");//c99标准允许编译
str1 = (ngx_str_t) ngx_null_string;          //c99标准允许编译

/*由于ngx_str_set与ngx_str_null实际上是两行语句，故在if/for/while等语句中单独使用需要用花括号括起来，*/
ngx_str_t str;
if (cond)
   ngx_str_set(&str, "true");     // 问题产生
else
   ngx_str_set(&str, "false");    // 问题产生

void ngx_strlow(u_char *dst, u_char *src, size_t n);//将src的前n个字符转换成小写存放在dst字符串中，调用者需要保证dst指向的空间大于等于n。
void ngx_strncmp(u_char *dst, u_char *src, size_t n);//区分大小写的字符串比较，只比较前n个字符。
void ngx_strcmp(u_char *dst, u_char *src);//区分大小写的不带长度的字符串比较。
ngx_int_t ngx_strcasecmp(u_char *s1, u_char *s2);//不区分大小写的不带长度的字符串比较。
ngx_int_t ngx_strncasecmp(u_char *s1, u_char *s2, size_t n);//不区分大小写的带长度的字符串比较，只比较前n个字符。

/*下面这三个函数用于字符串格式化，
ngx_snprintf的第二个参数max指明buf的空间大小，
ngx_slprintf则通过last来指明buf空间的大小。
推荐使用第二个或第三个函数来格式化字符串，ngx_sprintf函数还是比较危险的，容易产生缓冲区溢出漏洞。
在这一系列函数中，nginx在兼容glibc中格式化字符串的形式之外，还添加了一些方便格式化nginx类型的一些转义字符，
比如%V用于格式化ngx_str_t结构。
在nginx源文件的ngx_string.c中有说明：*/
u_char * ngx_cdecl ngx_sprintf(u_char *buf, const char *fmt, ...);
u_char * ngx_cdecl ngx_snprintf(u_char *buf, size_t max, const char *fmt, ...);
u_char * ngx_cdecl ngx_slprintf(u_char *buf, u_char *last, const char *fmt, ...);

//对src进行反编码，type可以是0、NGX_UNESCAPE_URI、NGX_UNESCAPE_REDIRECT这三个值。
void ngx_unescape_uri(u_char **dst, u_char **src, size_t size, ngx_uint_t type);

uintptr_t ngx_escape_html(u_char *dst, u_char *src, size_t size);//对html标签进行编码。