nginx数据结构（ngx

字符串数据结构：

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标签进行编码。