#endianness #byteorder #wrapper

no-std endian-type

Type safe wrappers for types with a defined byte order

4 releases

0.2.0 Mar 6, 2023
0.1.2 Jul 28, 2015
0.1.1 Jul 27, 2015
0.1.0 Jul 27, 2015

#1173 in Encoding

Download history 149504/week @ 2024-07-22 140758/week @ 2024-07-29 144244/week @ 2024-08-05 149368/week @ 2024-08-12 155884/week @ 2024-08-19 177266/week @ 2024-08-26 157455/week @ 2024-09-02 176070/week @ 2024-09-09 161594/week @ 2024-09-16 198047/week @ 2024-09-23 213599/week @ 2024-09-30 185009/week @ 2024-10-07 184286/week @ 2024-10-14 181749/week @ 2024-10-21 184173/week @ 2024-10-28 263903/week @ 2024-11-04

825,127 downloads per month
Used in 506 crates (2 directly)

MIT license

14KB
273 lines

endian-type

crates.io Documentation License

Type safe wrappers for types with a defined byte order.

Example

use endian_type::{types, BigEndian, LittleEndian, NetworkOrder};

// The endianness reflects the type-safety of the declaration:
let foo = 0xbeef_u32;
let foo_be = BigEndian::from(foo);
assert_eq!(foo_be.to_bytes(), foo.to_be_bytes());
assert_eq!(foo_be.as_byte_slice(), &foo.to_be_bytes());

// One can convert back to the native representation using the `From`/`Into` traits:
assert_eq!(foo, foo_be.into());

// To operate on the wrapped types as if they are regular numbers, one has to
// be explicit and switch between the byte representations:
// Note: Internally, these are just [transmutations](https://doc.rust-lang.org/core/mem/fn.transmute.html) and should not affect performance.
let foo = u128::MAX;
let foo_le = LittleEndian::from(foo);
assert_eq!(
    LittleEndian::<u128>::from_bytes(u128::from_ne_bytes(foo_le.to_bytes()).wrapping_add(1).to_ne_bytes()),
    LittleEndian::<u128>::from(0)
);

// We also have a couple of aliases to be used as helper.
//
// This will assert our `NetworkOrder` type is in accordance with the IETF RFC1700.
let foo = -0xdead_i32;
let foo_no = NetworkOrder::from(foo);
let foo_be = types::i32_be::from(foo);
assert_eq!(foo.to_be_bytes(), foo_no.to_bytes());
assert_eq!(foo.to_be_bytes(), foo_be.to_bytes());

No runtime deps