annotate src/core/ngx_queue.h @ 7736:a46fcf101cfc

Core: added format specifiers to output binary data as hex. Now "s", "V", and "v" format specifiers may be prefixed with "x" (lowercase) or "X" (uppercase) to output corresponding data in hexadecimal format. In collaboration with Maxim Dounin.
author Vladimir Homutov <vl@nginx.com>
date Wed, 28 Oct 2020 10:56:11 +0300
parents d620f497c50f
children 3038bd4d7816
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1646
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
1
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
2 /*
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
3 * Copyright (C) Igor Sysoev
4412
d620f497c50f Copyright updated.
Maxim Konovalov <maxim@nginx.com>
parents: 2026
diff changeset
4 * Copyright (C) Nginx, Inc.
1646
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
5 */
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
6
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
7
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
8 #include <ngx_config.h>
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
9 #include <ngx_core.h>
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
10
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
11
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
12 #ifndef _NGX_QUEUE_H_INCLUDED_
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
13 #define _NGX_QUEUE_H_INCLUDED_
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
14
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
15
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
16 typedef struct ngx_queue_s ngx_queue_t;
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
17
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
18 struct ngx_queue_s {
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
19 ngx_queue_t *prev;
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
20 ngx_queue_t *next;
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
21 };
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
22
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
23
1684
d95dea42c33f ngx_queue_init()
Igor Sysoev <igor@sysoev.ru>
parents: 1646
diff changeset
24 #define ngx_queue_init(q) \
d95dea42c33f ngx_queue_init()
Igor Sysoev <igor@sysoev.ru>
parents: 1646
diff changeset
25 (q)->prev = q; \
1763
1043c21be8d2 style fix
Igor Sysoev <igor@sysoev.ru>
parents: 1684
diff changeset
26 (q)->next = q
1684
d95dea42c33f ngx_queue_init()
Igor Sysoev <igor@sysoev.ru>
parents: 1646
diff changeset
27
d95dea42c33f ngx_queue_init()
Igor Sysoev <igor@sysoev.ru>
parents: 1646
diff changeset
28
1646
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
29 #define ngx_queue_empty(h) \
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
30 (h == (h)->prev)
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
31
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
32
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
33 #define ngx_queue_insert_head(h, x) \
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
34 (x)->next = (h)->next; \
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
35 (x)->next->prev = x; \
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
36 (x)->prev = h; \
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
37 (h)->next = x
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
38
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
39
2026
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
40 #define ngx_queue_insert_after ngx_queue_insert_head
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
41
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
42
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
43 #define ngx_queue_insert_tail(h, x) \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
44 (x)->prev = (h)->prev; \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
45 (x)->prev->next = x; \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
46 (x)->next = h; \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
47 (h)->prev = x
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
48
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
49
1646
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
50 #define ngx_queue_head(h) \
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
51 (h)->next
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
52
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
53
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
54 #define ngx_queue_last(h) \
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
55 (h)->prev
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
56
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
57
2026
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
58 #define ngx_queue_sentinel(h) \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
59 (h)
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
60
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
61
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
62 #define ngx_queue_next(q) \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
63 (q)->next
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
64
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
65
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
66 #define ngx_queue_prev(q) \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
67 (q)->prev
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
68
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
69
1646
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
70 #if (NGX_DEBUG)
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
71
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
72 #define ngx_queue_remove(x) \
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
73 (x)->next->prev = (x)->prev; \
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
74 (x)->prev->next = (x)->next; \
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
75 (x)->prev = NULL; \
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
76 (x)->next = NULL
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
77
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
78 #else
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
79
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
80 #define ngx_queue_remove(x) \
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
81 (x)->next->prev = (x)->prev; \
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
82 (x)->prev->next = (x)->next
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
83
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
84 #endif
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
85
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
86
2026
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
87 #define ngx_queue_split(h, q, n) \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
88 (n)->prev = (h)->prev; \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
89 (n)->prev->next = n; \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
90 (n)->next = q; \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
91 (h)->prev = (q)->prev; \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
92 (h)->prev->next = h; \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
93 (q)->prev = n;
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
94
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
95
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
96 #define ngx_queue_add(h, n) \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
97 (h)->prev->next = (n)->next; \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
98 (n)->next->prev = (h)->prev; \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
99 (h)->prev = (n)->prev; \
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
100 (h)->prev->next = h;
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
101
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
102
1646
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
103 #define ngx_queue_data(q, type, link) \
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
104 (type *) ((u_char *) q - offsetof(type, link))
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
105
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
106
2026
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
107 ngx_queue_t *ngx_queue_middle(ngx_queue_t *queue);
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
108 void ngx_queue_sort(ngx_queue_t *queue,
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
109 ngx_int_t (*cmp)(const ngx_queue_t *, const ngx_queue_t *));
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
110
72db8932f782 new ngx_queue functions
Igor Sysoev <igor@sysoev.ru>
parents: 1763
diff changeset
111
1646
9638a809d3cd ngx_queue.h
Igor Sysoev <igor@sysoev.ru>
parents:
diff changeset
112 #endif /* _NGX_QUEUE_H_INCLUDED_ */