| # Bit-Pointer Ranges |
| |
| This module defines ports of the `Range` type family to work with `BitPtr`s. |
| Rust’s own ranges have unstable internal details that make them awkward to use |
| within the standard library, and essentially impossible outside it, with |
| anything other than the numeric fundamentals. |
| |
| In particular, `bitvec` uses a half-open range of `BitPtr`s to represent |
| C++-style dual-pointer memory regions (such as `BitSlice` iterators). Rust’s own |
| slice iterators also do this, but because `*T` does not implement the [`Step`] |
| trait, the standard library duplicates some work done by `Range` types in the |
| slice iterators just to be able to alter the views. |
| |
| As such, `Range<BitPtr<_, _, _>>` has the same functionality as |
| `Range<*const _>`: almost none. As this is undesirable, this module defines |
| equivalent types that implement the full desired behavior of a pointer range. |
| These are primarily used as crate internals, but may also be of interest to |
| users. |
| |
| [`Step`]: core::iter::Step |
