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并不保证以'\0'结尾，所以必须配合len去使用，否则极其容易造成缓冲区溢出。另外，不保证以'\0'也就说明它是二进制安全的。

 

下面看一下比较简单的一些函数，都是用宏对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 *)text3 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。

 

还有一些需要再补充……