#unsigned-integer #big-integer #byte #u8 #conversion #type #byte-array

big_unsigned_ints

A Crate For Big Unsigned Integers ranging from U256 to U2048 using u64 arrays all under a fixed-size of 32

7 releases

0.1.6 Jan 11, 2021
0.1.5 Nov 28, 2019
0.1.3 Oct 18, 2019

#810 in Data structures

35 downloads per month

Apache-2.0 AND MIT

16KB
249 lines

Big_Unsigned_Ints

Crates.io Build Status

Description

Big_Unsigned_Ints is a crate for Rust that allows you to use large unsigned integers ranging from U256 through U2048. These are implemented using fixed-sized arrays and converts from u8 to u64 types. It also allows you to convert back from u64 to an array of u8s without using unsafe code.

The u8 -> u64 conversion uses mem::transmute with unsafe code to perform the process.

No functions should be used aside from the standard traits From and Into to convert between u8 and u64.

How To Use

Write the following inside your cargo.toml file under dependencies:

big_unsigned_ints = "0.1.6"

Then, you can import it like so:

extern crate big_unsigned_ints;

Please view the tests folder for integration testing and how you can use the library itself.

Standard Documentation On Usage

Converting Array of Bytes To U256 Type

fn example_bytes (){
    // 32-fixed sized array of bytes
    let x = [243u8;32];

    // Conversion Occurs From Bytes of Array To The Type
    let y = big_unsigned_ints::U256::from(x);

    // Prints as Hexadecimal
    println!("{}",y)
}

Converting Array of Bytes To U256 Type Back To An Array Of Bytes

fn bytes_to_big_int (){
    // Create an array of 32x 243u8, or 256bits
    let x = [243u8;32];

    // Convert From the Array of Bytes Into a U256 Type ([u64;4])
    let y = big_unsigned_ints::U256::from(x);

    // Convert Back Into An Array of Bytes Specifying the Type For Bytes
    let b: [u8;32] = y.into();
}

Available Types

  • U256 [u64;4] | [u8;32]

  • U384 [u64;6] | [u8;48]

  • U512 [u64;8] | [u8;64]

  • U1024 [u64;16] | [u8;128]

  • U2048 [u64;32] | [u8;256]

License

  • MIT License

  • Apache 2.0

No runtime deps