288 and iterate until the end, or the beginning of the list, respectively. |
288 and iterate until the end, or the beginning of the list, respectively. |
289 |
289 |
290 The functions with `Mut` in are equivalently, except that they create a [mutating iterator](iterator.h.md#mutating-iterators). |
290 The functions with `Mut` in are equivalently, except that they create a [mutating iterator](iterator.h.md#mutating-iterators). |
291 Removing elements via a mutating iterator will cause an invocation of the [destructor functions](collection.h.md#destructor-functions) for the removed element. |
291 Removing elements via a mutating iterator will cause an invocation of the [destructor functions](collection.h.md#destructor-functions) for the removed element. |
292 |
292 |
293 If is safe to specify an out-of-bounds index in which case an iterator is returned for which `cxIteratorValid()` returns `false`, immediately. |
293 If is safe to specify an out-of-bounds index, or a `NULL` pointer, in which cases an iterator is returned for which `cxIteratorValid()` returns `false`, immediately. |
294 |
294 |
295 ## Reorder |
295 ## Reorder |
296 |
296 |
297 ```C |
297 ```C |
298 #include <cx/list.h> |
298 #include <cx/list.h> |