#byte #byte-slice #integer #read #zeroed #bench #u64

from_bytes_or_zeroed

Reads integers from an arbitrary slice of bytes

1 unstable release

0.1.0 May 14, 2023

#1929 in Algorithms

Download history 6082/week @ 2024-10-05 3514/week @ 2024-10-12 3982/week @ 2024-10-19 4566/week @ 2024-10-26 3672/week @ 2024-11-02 2600/week @ 2024-11-09 2200/week @ 2024-11-16 1841/week @ 2024-11-23 1529/week @ 2024-11-30 3383/week @ 2024-12-07 2945/week @ 2024-12-14 679/week @ 2024-12-21 781/week @ 2024-12-28 2357/week @ 2025-01-04 2916/week @ 2025-01-11 3548/week @ 2025-01-18

9,665 downloads per month
Used in 12 crates (via bitcode_lightyear_patch)

MIT/Apache

15KB
250 lines

from_bytes_or_zeroed

A crate that reads integers from an arbitrary slice of bytes


lib.rs:

from_bytes_or_zeroed is a crate for creating integers from a slice of bytes of any length.

Usage

use from_bytes_or_zeroed::FromBytesOrZeroed;

// If there are too few bytes the remaining bytes are zeroed.
let a = [1, 2];
let b = [1, 2, 0, 0, 0, 0, 0, 0];
assert_eq!(u64::from_le_bytes_or_zeroed(&a), u64::from_le_bytes(b));

// If there are too many bytes the extra bytes are ignored.
let a = [1, 2, 3, 4, 5, 6];
let b = [1, 2, 3, 4];
assert_eq!(u32::from_le_bytes_or_zeroed(&a), u32::from_le_bytes(b));

Motivation

This crate was created because implementing this operation for [prim@u64] in safe Rust was significantly slower than using unsafe.

test benches::bench_u64_safe    ... bench:       1,509 ns/iter (+/- 29)
test benches::bench_u64_unsafe  ... bench:         644 ns/iter (+/- 8)

No runtime deps