#offset #mem #offset_of #offsetof

no-std memoffset

offset_of functionality for Rust structs

6 releases (3 breaking)

0.5.1 Jul 15, 2019
0.5.0 Jul 14, 2019
0.4.0 Jul 4, 2019
0.3.0 Mar 15, 2019
0.1.0 Oct 17, 2017

#4 in No standard library

Download history 83555/week @ 2019-06-05 86403/week @ 2019-06-12 87602/week @ 2019-06-19 86341/week @ 2019-06-26 73069/week @ 2019-07-03 77714/week @ 2019-07-10 81780/week @ 2019-07-17 102442/week @ 2019-07-24 106267/week @ 2019-07-31 116383/week @ 2019-08-07 114106/week @ 2019-08-14 106578/week @ 2019-08-21 103315/week @ 2019-08-28 120347/week @ 2019-09-04 112815/week @ 2019-09-11

327,969 downloads per month
Used in 2,464 crates (15 directly)

MIT license

19KB
252 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