https://github.com/alexanderschuetz97/intsplit
Rust library for splitting various numeric types into their binary component types
https://github.com/alexanderschuetz97/intsplit
Last synced: about 2 months ago
JSON representation
Rust library for splitting various numeric types into their binary component types
- Host: GitHub
- URL: https://github.com/alexanderschuetz97/intsplit
- Owner: AlexanderSchuetz97
- License: mit
- Created: 2024-05-21T20:18:21.000Z (12 months ago)
- Default Branch: master
- Last Pushed: 2024-05-21T21:35:51.000Z (12 months ago)
- Last Synced: 2025-02-28T16:55:29.478Z (3 months ago)
- Language: Rust
- Size: 4.88 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# intsplit
Rust library for splitting numeric types into their binary component arrays.
### Example
```rust
use intsplit::*;
#[test]
fn example() {
let number : u32 = 0x0A0B0C0Du32;
let u16_components: [u16; 2] = number.as_u16_array();
assert_eq!([0x0C0Du16, 0x0A0Bu16], u16_components);
}
```
### Implemented transmutes
This library uses no unsafe code (only in tests) to implement the transmutes.
The rust compiler will recognize that all these operations are essentially transmutes
and optimize similarly (on optimized builds)
#### u16/i16:
- as_i8_array -> [i8; 2]
#### u32/i32/f32:
- as_i8_array -> [i8; 4]
- as_i16_array -> [i16; 2]
- as_u16_array -> [u16; 2]
#### u64/i64/f64:
- as_i8_array -> [i8; 8]
- as_i16_array -> [i16; 4]
- as_u16_array -> [u16; 4]
- as_i32_array -> [i32; 2]
- as_u32_array -> [u32; 2]
- as_f32_array -> [f32; 2]
#### u128/i128:
- as_i8_array -> [i8; 16]
- as_i16_array -> [i16; 8]
- as_u16_array -> [u16; 8]
- as_i32_array -> [i32; 4]
- as_u32_array -> [u32; 4]
- as_f32_array -> [f32; 4]
- as_i64_array -> [i64; 2]
- as_u64_array -> [u64; 2]
- as_f64_array -> [f64; 2]
### Beware of endianness
Please note that the result is always equivalent to transmuting the to_ne_bytes() result to the respective array.
The example provided in this readme will not work on big endian targets as that would swap the 2 u16 values in the assert statement,
just like mem::transmute - ing the result of to_ne_bytes() would not yield the same result on little and big endian.