#offset #mem #offset_of #offsetof

no-std memoffset

offset_of functionality for Rust structs

4 releases (2 breaking)

0.3.0 Mar 15, 2019
0.2.1 Jan 15, 2018
0.2.0 Jan 13, 2018
0.1.0 Oct 17, 2017

#6 in No standard library

Download history 38200/week @ 2018-12-20 15323/week @ 2018-12-27 52878/week @ 2019-01-03 53094/week @ 2019-01-10 59065/week @ 2019-01-17 54591/week @ 2019-01-24 58197/week @ 2019-01-31 65140/week @ 2019-02-07 66859/week @ 2019-02-14 69217/week @ 2019-02-21 72299/week @ 2019-02-28 73414/week @ 2019-03-07 71833/week @ 2019-03-14 68082/week @ 2019-03-21 71167/week @ 2019-03-28

274,399 downloads per month
Used in 1,580 crates (5 directly)

MIT license

21KB
305 lines

memoffset

C-Like offset_of functionality for Rust structs.

Introduces the following macros:

  • offset_of! for obtaining the offset of a member of a struct.
  • span_of! for obtaining the range that a field, or fields, span.

memoffset works under no_std environments.

Usage

Add the following dependency to your Cargo.toml:

[dependencies]
memoffset = "0.3"

Versions ">= 0.3" can be used in a constant expression context (though not in a const fn), but require a rust version greater than or equal to 1.33. These versions will compile fine with rustc versions greater or equal to 1.19, but will lack support for constant expression.

If you wish to use an older rustc version, lock your dependency to "0.2"

Add the following lines at the top of your main.rs or lib.rs files.

#[macro_use]
extern crate memoffset;

Examples

#[repr(C, packed)]
struct Foo {
	a: u32,
	b: u32,
	c: [u8; 5],
	d: u32,
}

assert_eq!(offset_of!(Foo, b), 4);
assert_eq!(offset_of!(Foo, c[3]), 11);

assert_eq!(span_of!(Foo, a),          0..4);
assert_eq!(span_of!(Foo, a ..  c),    0..8);
assert_eq!(span_of!(Foo, a ..  c[1]), 0..9);
assert_eq!(span_of!(Foo, a ..= c[1]), 0..10);
assert_eq!(span_of!(Foo, ..= d),      0..14);
assert_eq!(span_of!(Foo, b ..),       4..17);

No runtime deps

~12KB