#no-std #raw #pointer

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

Uses old Rust 2015

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

#276 in Rust patterns

Download history 45747/week @ 2021-05-30 48134/week @ 2021-06-06 48830/week @ 2021-06-13 49462/week @ 2021-06-20 45071/week @ 2021-06-27 48883/week @ 2021-07-04 52908/week @ 2021-07-11 52609/week @ 2021-07-18 54577/week @ 2021-07-25 53639/week @ 2021-08-01 51359/week @ 2021-08-08 50280/week @ 2021-08-15 54323/week @ 2021-08-22 51384/week @ 2021-08-29 56521/week @ 2021-09-05 64690/week @ 2021-09-12

195,134 downloads per month
Used in 654 crates (8 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