#raw #pointer #no_std

no-std rawpointer

Extra methods for raw pointers and NonNull<T>. For example .post_inc() and .pre_dec() (c.f. ptr++ and --ptr), offset and add for NonNull<T>, and the function ptrdistance.

3 unstable releases

0.2.1 Sep 12, 2019
0.2.0 Sep 8, 2019
0.1.0 Dec 15, 2016

#21 in No standard library

Download history 14007/week @ 2019-12-02 13592/week @ 2019-12-09 14098/week @ 2019-12-16 7110/week @ 2019-12-23 7565/week @ 2019-12-30 13005/week @ 2020-01-06 19476/week @ 2020-01-13 27399/week @ 2020-01-20 11714/week @ 2020-01-27 11349/week @ 2020-02-03 12348/week @ 2020-02-10 12401/week @ 2020-02-17 11940/week @ 2020-02-24 13082/week @ 2020-03-02 11826/week @ 2020-03-09 13226/week @ 2020-03-16

53,772 downloads per month
Used in 323 crates (6 directly)

MIT/Apache

9KB
140 lines

rawpointer

Please read the API documentation here

build_status crates

Recent Changes

  • 0.2.0
    • Add support for NonNull<T>
    • Added more documentation and an example
    • Now requires Rust 1.26 or later
  • 0.1.0
    • Initial release

lib.rs:

Rawpointer adds extra utility methods to raw pointers *const T, *mut T and NonNull<T>.

Features include:

  • Strided offsets - .stride_offset(stride, index) make it easy to compute pointer offsets where the index is unsigned and the stride is signed.

  • Offsetting methods in general for NonNull, since it does not have these from libcore

  • Post- and preincrement and post- and predecrement methods

use rawpointer::PointerExt;

unsafe {
    // In this example:
    // Use .post_inc() to iterate and overwrite the first four
    // elements of the array.

    let mut xs = [0; 16];
    let mut ptr = xs.as_mut_ptr();
    let end = ptr.offset(4);
    let mut i = 0;
    while ptr != end {
        *ptr.post_inc() = i;
        i += 1;
    }
    assert_eq!(&xs[..8], &[0, 1, 2, 3, 0, 0, 0, 0]);
}

Safety

See the Rust [core::ptr] documentation for more information.

Rust Version

This version of the crate requires Rust 1.26 or later

No runtime deps