nginx中关于字符串的数据结构位于src/core/ngx_string.c和src/core/ngx_string.h中
先来看一下数据结构:
1 typedef struct { 2 size_t len; 3 u_char *data; 4 } ngx_str_t;
data指针指向字符串起始地址,len表示字符串的有效长度。这里面的data并不保证以' '结尾,所以必须配合len去使用,否则极其容易造成缓冲区溢出。另外,不保证以' '也就说明它是二进制安全的。
下面看一下比较简单的一些函数,都是用宏对C语言中字符串的库函数做了一层封装而已。
Nginx 字符串的初始化使用 ngx_string 或 ngx_null_string ,这两个宏定义如下:
1 #define ngx_string(str) {sizeof(str)-1, (u_char *) str} 2 #define ngx_null_string {0, NULL}
若已经定义了 Nginx 字符串变量之后再赋值,则必须使用 ngx_str_set, ngx_str_null 宏定义:
1 #define ngx_str_set(str, text) 2 (str)->len = sizeof(text)-1; (str)->data = (u_char *)text 3 4 #define ngx_str_null(str) (str)->len = 0; (str)->data = NULL
以下是例子:
1 /* 例如:*/ 2 /* 正确写法*/ 3 ngx_str_t str1 = ngx_string("hello nginx"); 4 ngx_str_t str2 = ngx_null_string; 5 6 /* 错误写法*/ 7 ngx_str_t str1, str2; 8 str1 = ngx_string("hello nginx"); /* 编译出错 */ 9 str2 = ngx_null_string; /* 编译出错 */ 10 11 /* 正确写法*/ 12 ngx_str_t str1, str2; 13 ngx_str_set(&str1, "hello nginx"); 14 ngx_str_null(&str2); 15 /* 注意:ngx_string 和 ngx_str_set 字符串参数必须是常量字符串,不能是变量字符串 */
1 #define ngx_strncmp(s1, s2, n) strncmp((const char *) s1, (const char *) s2, n)
1 #define ngx_strcmp(s1, s2) strcmp((const char *) s1, (const char *) s2)
1 #define ngx_strstr(s1, s2) strstr((const char *) s1, (const char *) s2)
1 #define ngx_strlen(s) strlen((const char *) s)
1 #define ngx_strchr(s1, c) strchr((const char *) s1, (int) c)
1 #define ngx_memzero(buf, n) (void) memset(buf, 0, n) 2 #define ngx_memset(buf, c, n) (void) memset(buf, c, n)
1 #define ngx_memcpy(dst, src, n) (void) memcpy(dst, src, n) 2 #define ngx_cpymem(dst, src, n) (((u_char *) memcpy(dst, src, n)) + (n))
1 #define ngx_memmove(dst, src, n) (void) memmove(dst, src, n) 2 #define ngx_movemem(dst, src, n) (((u_char *) memmove(dst, src, n)) + (n))
1 #define ngx_memcmp(s1, s2, n) memcmp((const char *) s1, (const char *) s2, n)
这些函数都没有什么好解释的。
转换大小写的函数:
1 #define ngx_tolower(c) (u_char) ((c >= 'A' && c <= 'Z') ? (c | 0x20) : c) 2 #define ngx_toupper(c) (u_char) ((c >= 'a' && c <= 'z') ? (c & ~0x20) : c)
这里非常巧妙,就是对第6位进行处理,大小写字母的差是32,而0x20对应32。
还有一些需要再补充……