Crate memoffset

A crate used for calculating offsets of struct members and their spans.

This functionality currently can not be used in compile time code such as const or const fn definitions.

Examples

use memoffset::{offset_of, span_of};

#[repr(C, packed)]
struct HelpMeIAmTrappedInAStructFactory {
    help_me_before_they_: [u8; 15],
    a: u32
}

assert_eq!(offset_of!(HelpMeIAmTrappedInAStructFactory, a), 15);
assert_eq!(span_of!(HelpMeIAmTrappedInAStructFactory, a), 15..19);
assert_eq!(span_of!(HelpMeIAmTrappedInAStructFactory, help_me_before_they_ .. a), 0..15);

This functionality can be useful, for example, for checksum calculations:

#[repr(C, packed)]
struct Message {
    header: MessageHeader,
    fragment_index: u32,
    fragment_count: u32,
    payload: [u8; 1024],
    checksum: u16
}

let checksum_range = &raw[span_of!(Message, header..checksum)];
let checksum = crc16(checksum_range);

Macros

• offset_of
  Calculates the offset of the specified field from the start of the named struct.
• offset_of_tuple
  Calculates the offset of the specified field from the start of the tuple.
• offset_of_union
  Calculates the offset of the specified union member from the start of the union.
• raw_field
  Computes a const raw pointer to the given field of the given base pointer to the given parent type.
• raw_field_tuple
  Computes a const raw pointer to the given field of the given base pointer to the given parent tuple type.
• raw_field_union
  Computes a const raw pointer to the given field of the given base pointer to the given parent tuple type.
• span_of
  Produces a range instance representing the sub-slice containing the specified member.