字符串数据结构:
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标签进行编码。