]>
git.proxmox.com Git - mirror_ovs.git/blob - lib/list.c
2 * Copyright (c) 2008, 2009, 2010, 2011 Nicira Networks.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at:
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
20 /* Initializes 'list' as an empty list. */
22 list_init(struct list
*list
)
24 list
->next
= list
->prev
= list
;
27 /* Initializes 'list' with pointers that will (probably) cause segfaults if
28 * dereferenced and, better yet, show up clearly in a debugger. */
30 list_poison(struct list
*list
)
32 memset(list
, 0xcc, sizeof *list
);
35 /* Inserts 'elem' just before 'before'. */
37 list_insert(struct list
*before
, struct list
*elem
)
39 elem
->prev
= before
->prev
;
41 before
->prev
->next
= elem
;
45 /* Removes elements 'first' though 'last' (exclusive) from their current list,
46 then inserts them just before 'before'. */
48 list_splice(struct list
*before
, struct list
*first
, struct list
*last
)
54 /* Cleanly remove 'first'...'last' from its current list. */
55 first
->prev
->next
= last
->next
;
56 last
->next
->prev
= first
->prev
;
58 /* Splice 'first'...'last' into new list. */
59 first
->prev
= before
->prev
;
61 before
->prev
->next
= first
;
65 /* Inserts 'elem' at the beginning of 'list', so that it becomes the front in
68 list_push_front(struct list
*list
, struct list
*elem
)
70 list_insert(list
->next
, elem
);
73 /* Inserts 'elem' at the end of 'list', so that it becomes the back in
76 list_push_back(struct list
*list
, struct list
*elem
)
78 list_insert(list
, elem
);
81 /* Puts 'elem' in the position currently occupied by 'position'.
82 * Afterward, 'position' is not part of a list. */
84 list_replace(struct list
*element
, const struct list
*position
)
86 element
->next
= position
->next
;
87 element
->next
->prev
= element
;
88 element
->prev
= position
->prev
;
89 element
->prev
->next
= element
;
92 /* Adjusts pointers around 'list' to compensate for 'list' having been moved
93 * around in memory (e.g. as a consequence of realloc()). */
95 list_moved(struct list
*list
)
97 list
->prev
->next
= list
->next
->prev
= list
;
100 /* Removes 'elem' from its list and returns the element that followed it.
101 Undefined behavior if 'elem' is not in a list. */
103 list_remove(struct list
*elem
)
105 elem
->prev
->next
= elem
->next
;
106 elem
->next
->prev
= elem
->prev
;
110 /* Removes the front element from 'list' and returns it. Undefined behavior if
111 'list' is empty before removal. */
113 list_pop_front(struct list
*list
)
115 struct list
*front
= list
->next
;
120 /* Removes the back element from 'list' and returns it.
121 Undefined behavior if 'list' is empty before removal. */
123 list_pop_back(struct list
*list
)
125 struct list
*back
= list
->prev
;
130 /* Returns the front element in 'list_'.
131 Undefined behavior if 'list_' is empty. */
133 list_front(const struct list
*list_
)
135 struct list
*list
= (struct list
*) list_
;
137 assert(!list_is_empty(list
));
141 /* Returns the back element in 'list_'.
142 Undefined behavior if 'list_' is empty. */
144 list_back(const struct list
*list_
)
146 struct list
*list
= (struct list
*) list_
;
148 assert(!list_is_empty(list
));
152 /* Returns the number of elements in 'list'.
153 Runs in O(n) in the number of elements. */
155 list_size(const struct list
*list
)
157 const struct list
*e
;
160 for (e
= list
->next
; e
!= list
; e
= e
->next
)
165 /* Returns true if 'list' is empty, false otherwise. */
167 list_is_empty(const struct list
*list
)
169 return list
->next
== list
;
172 /* Returns true if 'list' has exactly 1 element, false otherwise. */
174 list_is_singleton(const struct list
*list
)
176 return list_is_short(list
) && !list_is_empty(list
);
179 /* Returns true if 'list' has 0 or 1 elements, false otherwise. */
181 list_is_short(const struct list
*list
)
183 return list
->next
== list
->prev
;