3 * Copyright (C) Igor Sysoev
7 #ifndef _NGX_STRING_H_INCLUDED_
8 #define _NGX_STRING_H_INCLUDED_
11 #include <ngx_config.h>
31 unsigned no_cacheable
:1;
36 } ngx_variable_value_t
;
39 #define ngx_string(str) { sizeof(str) - 1, (u_char *) str }
40 #define ngx_null_string { 0, NULL }
43 #define ngx_tolower(c) (u_char) ((c >= 'A' && c <= 'Z') ? (c | 0x20) : c)
44 #define ngx_toupper(c) (u_char) ((c >= 'a' && c <= 'z') ? (c & ~0x20) : c)
46 void ngx_strlow(u_char
*dst
, u_char
*src
, size_t n
);
49 #define ngx_strncmp(s1, s2, n) strncmp((const char *) s1, (const char *) s2, n)
52 /* msvc and icc7 compile strcmp() to inline loop */
53 #define ngx_strcmp(s1, s2) strcmp((const char *) s1, (const char *) s2)
56 #define ngx_strstr(s1, s2) strstr((const char *) s1, (const char *) s2)
57 #define ngx_strchr(s1, c) strchr((const char *) s1, (int) c)
58 #define ngx_strlen(s) strlen((const char *) s)
62 * msvc and icc7 compile memset() to the inline "rep stos"
63 * while ZeroMemory() and bzero() are the calls.
64 * icc7 may also inline several mov's of a zeroed register for small blocks.
66 #define ngx_memzero(buf, n) (void) memset(buf, 0, n)
67 #define ngx_memset(buf, c, n) (void) memset(buf, c, n)
70 #if (NGX_MEMCPY_LIMIT)
72 void *ngx_memcpy(void *dst
, void *src
, size_t n
);
73 #define ngx_cpymem(dst, src, n) ((u_char *) ngx_memcpy(dst, src, n)) + (n)
78 * gcc3, msvc, and icc7 compile memcpy() to the inline "rep movs".
79 * gcc3 compiles memcpy(d, s, 4) to the inline "mov"es.
80 * icc8 compile memcpy(d, s, 4) to the inline "mov"es or XMM moves.
82 #define ngx_memcpy(dst, src, n) (void) memcpy(dst, src, n)
83 #define ngx_cpymem(dst, src, n) ((u_char *) memcpy(dst, src, n)) + (n)
88 #if ( __INTEL_COMPILER >= 800 )
91 * the simple inline cycle copies the variable length strings up to 16
92 * bytes faster than icc8 autodetecting _intel_fast_memcpy()
95 static ngx_inline u_char
*
96 ngx_copy(u_char
*dst
, u_char
*src
, size_t len
)
108 return ngx_cpymem(dst
, src
, len
);
114 #define ngx_copy ngx_cpymem
119 /* msvc and icc7 compile memcmp() to the inline loop */
120 #define ngx_memcmp(s1, s2, n) memcmp((const char *) s1, (const char *) s2, n)
123 u_char
*ngx_cpystrn(u_char
*dst
, u_char
*src
, size_t n
);
124 u_char
*ngx_pstrdup(ngx_pool_t
*pool
, ngx_str_t
*src
);
125 u_char
* ngx_cdecl
ngx_sprintf(u_char
*buf
, const char *fmt
, ...);
126 u_char
* ngx_cdecl
ngx_snprintf(u_char
*buf
, size_t max
, const char *fmt
, ...);
127 u_char
*ngx_vsnprintf(u_char
*buf
, size_t max
, const char *fmt
, va_list args
);
129 ngx_int_t
ngx_strcasecmp(u_char
*s1
, u_char
*s2
);
130 ngx_int_t
ngx_strncasecmp(u_char
*s1
, u_char
*s2
, size_t n
);
132 u_char
*ngx_strnstr(u_char
*s1
, char *s2
, size_t n
);
134 u_char
*ngx_strstrn(u_char
*s1
, char *s2
, size_t n
);
135 u_char
*ngx_strcasestrn(u_char
*s1
, char *s2
, size_t n
);
137 ngx_int_t
ngx_rstrncmp(u_char
*s1
, u_char
*s2
, size_t n
);
138 ngx_int_t
ngx_rstrncasecmp(u_char
*s1
, u_char
*s2
, size_t n
);
139 ngx_int_t
ngx_memn2cmp(u_char
*s1
, u_char
*s2
, size_t n1
, size_t n2
);
141 ngx_int_t
ngx_atoi(u_char
*line
, size_t n
);
142 ssize_t
ngx_atosz(u_char
*line
, size_t n
);
143 off_t
ngx_atoof(u_char
*line
, size_t n
);
144 time_t ngx_atotm(u_char
*line
, size_t n
);
145 ngx_int_t
ngx_hextoi(u_char
*line
, size_t n
);
147 u_char
*ngx_hex_dump(u_char
*dst
, u_char
*src
, size_t len
);
150 #define ngx_base64_encoded_length(len) (((len + 2) / 3) * 4)
151 #define ngx_base64_decoded_length(len) (((len + 3) / 4) * 3)
153 void ngx_encode_base64(ngx_str_t
*dst
, ngx_str_t
*src
);
154 ngx_int_t
ngx_decode_base64(ngx_str_t
*dst
, ngx_str_t
*src
);
156 uint32_t ngx_utf8_decode(u_char
**p
, size_t n
);
157 size_t ngx_utf8_length(u_char
*p
, size_t n
);
158 u_char
*ngx_utf8_cpystrn(u_char
*dst
, u_char
*src
, size_t n
, size_t len
);
161 #define NGX_ESCAPE_URI 0
162 #define NGX_ESCAPE_ARGS 1
163 #define NGX_ESCAPE_HTML 2
164 #define NGX_ESCAPE_REFRESH 3
165 #define NGX_ESCAPE_MEMCACHED 4
166 #define NGX_ESCAPE_MAIL_AUTH 5
168 #define NGX_UNESCAPE_URI 1
169 #define NGX_UNESCAPE_REDIRECT 2
171 uintptr_t ngx_escape_uri(u_char
*dst
, u_char
*src
, size_t size
,
173 void ngx_unescape_uri(u_char
**dst
, u_char
**src
, size_t size
, ngx_uint_t type
);
174 uintptr_t ngx_escape_html(u_char
*dst
, u_char
*src
, size_t size
);
178 void ngx_sort(void *base
, size_t n
, size_t size
,
179 ngx_int_t (*cmp
)(const void *, const void *));
180 #define ngx_qsort qsort
183 #define ngx_value_helper(n) #n
184 #define ngx_value(n) ngx_value_helper(n)
187 #endif /* _NGX_STRING_H_INCLUDED_ */