Annotation of embedaddon/nginx/src/core/ngx_string.h, revision 1.1.1.1
1.1 misho 1:
2: /*
3: * Copyright (C) Igor Sysoev
4: * Copyright (C) Nginx, Inc.
5: */
6:
7:
8: #ifndef _NGX_STRING_H_INCLUDED_
9: #define _NGX_STRING_H_INCLUDED_
10:
11:
12: #include <ngx_config.h>
13: #include <ngx_core.h>
14:
15:
16: typedef struct {
17: size_t len;
18: u_char *data;
19: } ngx_str_t;
20:
21:
22: typedef struct {
23: ngx_str_t key;
24: ngx_str_t value;
25: } ngx_keyval_t;
26:
27:
28: typedef struct {
29: unsigned len:28;
30:
31: unsigned valid:1;
32: unsigned no_cacheable:1;
33: unsigned not_found:1;
34: unsigned escape:1;
35:
36: u_char *data;
37: } ngx_variable_value_t;
38:
39:
40: #define ngx_string(str) { sizeof(str) - 1, (u_char *) str }
41: #define ngx_null_string { 0, NULL }
42: #define ngx_str_set(str, text) \
43: (str)->len = sizeof(text) - 1; (str)->data = (u_char *) text
44: #define ngx_str_null(str) (str)->len = 0; (str)->data = NULL
45:
46:
47: #define ngx_tolower(c) (u_char) ((c >= 'A' && c <= 'Z') ? (c | 0x20) : c)
48: #define ngx_toupper(c) (u_char) ((c >= 'a' && c <= 'z') ? (c & ~0x20) : c)
49:
50: void ngx_strlow(u_char *dst, u_char *src, size_t n);
51:
52:
53: #define ngx_strncmp(s1, s2, n) strncmp((const char *) s1, (const char *) s2, n)
54:
55:
56: /* msvc and icc7 compile strcmp() to inline loop */
57: #define ngx_strcmp(s1, s2) strcmp((const char *) s1, (const char *) s2)
58:
59:
60: #define ngx_strstr(s1, s2) strstr((const char *) s1, (const char *) s2)
61: #define ngx_strlen(s) strlen((const char *) s)
62:
63: #define ngx_strchr(s1, c) strchr((const char *) s1, (int) c)
64:
65: static ngx_inline u_char *
66: ngx_strlchr(u_char *p, u_char *last, u_char c)
67: {
68: while (p < last) {
69:
70: if (*p == c) {
71: return p;
72: }
73:
74: p++;
75: }
76:
77: return NULL;
78: }
79:
80:
81: /*
82: * msvc and icc7 compile memset() to the inline "rep stos"
83: * while ZeroMemory() and bzero() are the calls.
84: * icc7 may also inline several mov's of a zeroed register for small blocks.
85: */
86: #define ngx_memzero(buf, n) (void) memset(buf, 0, n)
87: #define ngx_memset(buf, c, n) (void) memset(buf, c, n)
88:
89:
90: #if (NGX_MEMCPY_LIMIT)
91:
92: void *ngx_memcpy(void *dst, const void *src, size_t n);
93: #define ngx_cpymem(dst, src, n) (((u_char *) ngx_memcpy(dst, src, n)) + (n))
94:
95: #else
96:
97: /*
98: * gcc3, msvc, and icc7 compile memcpy() to the inline "rep movs".
99: * gcc3 compiles memcpy(d, s, 4) to the inline "mov"es.
100: * icc8 compile memcpy(d, s, 4) to the inline "mov"es or XMM moves.
101: */
102: #define ngx_memcpy(dst, src, n) (void) memcpy(dst, src, n)
103: #define ngx_cpymem(dst, src, n) (((u_char *) memcpy(dst, src, n)) + (n))
104:
105: #endif
106:
107:
108: #if ( __INTEL_COMPILER >= 800 )
109:
110: /*
111: * the simple inline cycle copies the variable length strings up to 16
112: * bytes faster than icc8 autodetecting _intel_fast_memcpy()
113: */
114:
115: static ngx_inline u_char *
116: ngx_copy(u_char *dst, u_char *src, size_t len)
117: {
118: if (len < 17) {
119:
120: while (len) {
121: *dst++ = *src++;
122: len--;
123: }
124:
125: return dst;
126:
127: } else {
128: return ngx_cpymem(dst, src, len);
129: }
130: }
131:
132: #else
133:
134: #define ngx_copy ngx_cpymem
135:
136: #endif
137:
138:
139: #define ngx_memmove(dst, src, n) (void) memmove(dst, src, n)
140: #define ngx_movemem(dst, src, n) (((u_char *) memmove(dst, src, n)) + (n))
141:
142:
143: /* msvc and icc7 compile memcmp() to the inline loop */
144: #define ngx_memcmp(s1, s2, n) memcmp((const char *) s1, (const char *) s2, n)
145:
146:
147: u_char *ngx_cpystrn(u_char *dst, u_char *src, size_t n);
148: u_char *ngx_pstrdup(ngx_pool_t *pool, ngx_str_t *src);
149: u_char * ngx_cdecl ngx_sprintf(u_char *buf, const char *fmt, ...);
150: u_char * ngx_cdecl ngx_snprintf(u_char *buf, size_t max, const char *fmt, ...);
151: u_char * ngx_cdecl ngx_slprintf(u_char *buf, u_char *last, const char *fmt,
152: ...);
153: u_char *ngx_vslprintf(u_char *buf, u_char *last, const char *fmt, va_list args);
154: #define ngx_vsnprintf(buf, max, fmt, args) \
155: ngx_vslprintf(buf, buf + (max), fmt, args)
156:
157: ngx_int_t ngx_strcasecmp(u_char *s1, u_char *s2);
158: ngx_int_t ngx_strncasecmp(u_char *s1, u_char *s2, size_t n);
159:
160: u_char *ngx_strnstr(u_char *s1, char *s2, size_t n);
161:
162: u_char *ngx_strstrn(u_char *s1, char *s2, size_t n);
163: u_char *ngx_strcasestrn(u_char *s1, char *s2, size_t n);
164: u_char *ngx_strlcasestrn(u_char *s1, u_char *last, u_char *s2, size_t n);
165:
166: ngx_int_t ngx_rstrncmp(u_char *s1, u_char *s2, size_t n);
167: ngx_int_t ngx_rstrncasecmp(u_char *s1, u_char *s2, size_t n);
168: ngx_int_t ngx_memn2cmp(u_char *s1, u_char *s2, size_t n1, size_t n2);
169: ngx_int_t ngx_dns_strcmp(u_char *s1, u_char *s2);
170:
171: ngx_int_t ngx_atoi(u_char *line, size_t n);
172: ngx_int_t ngx_atofp(u_char *line, size_t n, size_t point);
173: ssize_t ngx_atosz(u_char *line, size_t n);
174: off_t ngx_atoof(u_char *line, size_t n);
175: time_t ngx_atotm(u_char *line, size_t n);
176: ngx_int_t ngx_hextoi(u_char *line, size_t n);
177:
178: u_char *ngx_hex_dump(u_char *dst, u_char *src, size_t len);
179:
180:
181: #define ngx_base64_encoded_length(len) (((len + 2) / 3) * 4)
182: #define ngx_base64_decoded_length(len) (((len + 3) / 4) * 3)
183:
184: void ngx_encode_base64(ngx_str_t *dst, ngx_str_t *src);
185: ngx_int_t ngx_decode_base64(ngx_str_t *dst, ngx_str_t *src);
186: ngx_int_t ngx_decode_base64url(ngx_str_t *dst, ngx_str_t *src);
187:
188: uint32_t ngx_utf8_decode(u_char **p, size_t n);
189: size_t ngx_utf8_length(u_char *p, size_t n);
190: u_char *ngx_utf8_cpystrn(u_char *dst, u_char *src, size_t n, size_t len);
191:
192:
193: #define NGX_ESCAPE_URI 0
194: #define NGX_ESCAPE_ARGS 1
195: #define NGX_ESCAPE_URI_COMPONENT 2
196: #define NGX_ESCAPE_HTML 3
197: #define NGX_ESCAPE_REFRESH 4
198: #define NGX_ESCAPE_MEMCACHED 5
199: #define NGX_ESCAPE_MAIL_AUTH 6
200:
201: #define NGX_UNESCAPE_URI 1
202: #define NGX_UNESCAPE_REDIRECT 2
203:
204: uintptr_t ngx_escape_uri(u_char *dst, u_char *src, size_t size,
205: ngx_uint_t type);
206: void ngx_unescape_uri(u_char **dst, u_char **src, size_t size, ngx_uint_t type);
207: uintptr_t ngx_escape_html(u_char *dst, u_char *src, size_t size);
208:
209:
210: typedef struct {
211: ngx_rbtree_node_t node;
212: ngx_str_t str;
213: } ngx_str_node_t;
214:
215:
216: void ngx_str_rbtree_insert_value(ngx_rbtree_node_t *temp,
217: ngx_rbtree_node_t *node, ngx_rbtree_node_t *sentinel);
218: ngx_str_node_t *ngx_str_rbtree_lookup(ngx_rbtree_t *rbtree, ngx_str_t *name,
219: uint32_t hash);
220:
221:
222: void ngx_sort(void *base, size_t n, size_t size,
223: ngx_int_t (*cmp)(const void *, const void *));
224: #define ngx_qsort qsort
225:
226:
227: #define ngx_value_helper(n) #n
228: #define ngx_value(n) ngx_value_helper(n)
229:
230:
231: #endif /* _NGX_STRING_H_INCLUDED_ */
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>