#fixed-size #conversion #architecture #pointers #64-bit

arch-into

safe type conversions between pointer-sized types (usize/isize) and types with fixed size

5 releases

0.0.1-alpha.5 Aug 9, 2023
0.0.1-alpha.4 Apr 7, 2023
0.0.1-alpha.3 Apr 6, 2023

#684 in Rust patterns

Download history 599/week @ 2023-12-16 298/week @ 2023-12-23 611/week @ 2023-12-30 700/week @ 2024-01-06 625/week @ 2024-01-13 330/week @ 2024-01-20 801/week @ 2024-01-27 765/week @ 2024-02-03 827/week @ 2024-02-10 1703/week @ 2024-02-17 2444/week @ 2024-02-24 2702/week @ 2024-03-02 1096/week @ 2024-03-09 1160/week @ 2024-03-16 853/week @ 2024-03-23 1899/week @ 2024-03-30

5,203 downloads per month

MIT/Apache

7KB
87 lines

arch-into

This crate provides simplified conversions between usize/isize types, and types with constant size, depending on supported architectures.

Typically, when you want to convert usize to u64 (or u32) you have few options:

  • Use as keyword. This approach may lead to incorrect results
  • Use try_from with unwrap/expect. When you target only 64-bits architectures this is fine, but it produces a lot of boilerplate
  • Use try_from and return error. This approach hides misbehavior of your code.

This crates provides two features: no-arch-32 and no-arch-64. If you try to compile for unsupported architecture, compilation will fail with the error.

Since unsupported pointer width is defined, we can use safe conversions for types with specific size.

Usage

use arch_into::{ArchInto, ArchFrom};

fn main() {
    let a: u64 = 23;
    let b: usize = a.arch_into();
    let _c = u64::arch_from(b);
}

Dependencies

~220KB