annotate src/core/ngx_queue.h @ 7682:2ab0ecfe5a5f

release-1.19.1 tag
author Maxim Dounin <mdounin@mdounin.ru>
date Tue, 07 Jul 2020 18:56:06 +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_ */