nginx源码学习_数据结构(ngx_str_t)

nginx中关于字符串的数据结构位于src/core/ngx_string.c和src/core/ngx_string.h中

先来看一下数据结构：

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

data指针指向字符串起始地址，len表示字符串的有效长度。这里面的data并不保证以'\0'结尾，所以必须配合len去使用，否则极其容易造成缓冲区溢出。另外，不保证以'\0'也就说明它是二进制安全的。

下面看一下比较简单的一些函数，都是用宏对C语言中字符串的库函数做了一层封装而已。

Nginx 字符串的初始化使用 ngx_string 或 ngx_null_string ，这两个宏定义如下：

 #define ngx_string(str) {sizeof(str)-1, (u_char *) str}
 #define ngx_null_string {0, NULL}

若已经定义了 Nginx 字符串变量之后再赋值，则必须使用 ngx_str_set, ngx_str_null 宏定义：

 #define ngx_str_set(str, text)
     (str)->len = sizeof(text)-; (str)->data = (u_char *)text

 #define ngx_str_null(str)   (str)->len = 0; (str)->data = NULL

以下是例子：

 /* 例如：*/
 /* 正确写法*/
 ngx_str_t str1 = ngx_string("hello nginx");
 ngx_str_t str2 = ngx_null_string;

 /* 错误写法*/
 ngx_str_t str1, str2;
 str1 = ngx_string("hello nginx");   /* 编译出错 */
 str2 = ngx_null_string;             /* 编译出错 */

 /* 正确写法*/
 ngx_str_t str1, str2;
 ngx_str_set(&str1, "hello nginx");
 ngx_str_null(&str2);
 /* 注意：ngx_string 和 ngx_str_set 字符串参数必须是常量字符串，不能是变量字符串 */

1 #define ngx_strncmp(s1, s2, n)  strncmp((const char *) s1, (const char *) s2, n)

 #define ngx_strcmp(s1, s2)  strcmp((const char *) s1, (const char *) s2)

 #define ngx_strstr(s1, s2)  strstr((const char *) s1, (const char *) s2)

 #define ngx_strlen(s)       strlen((const char *) s)

 #define ngx_strchr(s1, c)   strchr((const char *) s1, (int) c)

 #define ngx_memzero(buf, n)       (void) memset(buf, 0, n)
 #define ngx_memset(buf, c, n)     (void) memset(buf, c, n)

 #define ngx_memcpy(dst, src, n)   (void) memcpy(dst, src, n)
 #define ngx_cpymem(dst, src, n)   (((u_char *) memcpy(dst, src, n)) + (n))

 #define ngx_memmove(dst, src, n)   (void) memmove(dst, src, n)
 #define ngx_movemem(dst, src, n)   (((u_char *) memmove(dst, src, n)) + (n))

 #define ngx_memcmp(s1, s2, n)  memcmp((const char *) s1, (const char *) s2, n)

这些函数都没有什么好解释的。

转换大小写的函数：

 #define ngx_tolower(c)      (u_char) ((c >= 'A' && c <= 'Z') ? (c | 0x20) : c)
 #define ngx_toupper(c)      (u_char) ((c >= 'a' && c <= 'z') ? (c & ~0x20) : c)

这里非常巧妙，就是对第6位进行处理，大小写字母的差是32，而0x20对应32。

还有一些需要再补充……