#variable #length #leb128

no-std nano-leb128

Little endian base 128 variable-length code compression

1 unstable release

0.1.0 Jul 7, 2019

#431 in Compression

Download history 184/week @ 2023-06-07 66/week @ 2023-06-14 86/week @ 2023-06-21 161/week @ 2023-06-28 44/week @ 2023-07-05 207/week @ 2023-07-12 217/week @ 2023-07-19 459/week @ 2023-07-26 197/week @ 2023-08-02 273/week @ 2023-08-09 164/week @ 2023-08-16 118/week @ 2023-08-23 198/week @ 2023-08-30 142/week @ 2023-09-06 156/week @ 2023-09-13 83/week @ 2023-09-20

626 downloads per month
Used in 3 crates

MIT/Apache

20KB
252 lines

nano: leb128

Little endian base 128 variable-length code compression.

Usage

Signed LEB128 compression/decompression:

use nano_leb128::SLEB128;

fn rand_i64() -> i64 {
    // ...
}

let mut buf = [0; 10];
let value = rand_i64();

// Compress the value into the buffer.
let len = SLEB128::from(value).write_into(&mut buf).unwrap();

// Decompress the value from the buffer.
let (decompressed, _len) = SLEB128::read_from(&buf[..len]).unwrap();

assert_eq!(i64::from(decompressed), value);

Unsigned LEB128 compression/decompression:

use nano_leb128::ULEB128;

fn rand_u64() -> u64 {
    // ...
}

let mut buf = [0; 10];
let value = rand_u64();

// Compress the value into the buffer.
let len = ULEB128::from(value).write_into(&mut buf).unwrap();

// Decompress the value from the buffer.
let (decompressed, _len) = ULEB128::read_from(&buf[..len]).unwrap();

assert_eq!(u64::from(decompressed), value);

Features

  • std (enabled by default)

    This enables extensions that are only available with the Rust standard library.

  • std_io_ext

    Adds methods for reading/writing LEB128 compressed values from implementors of the traits in std::io. This feature requires the std feature and will automatically enable it if it is not already enabled.

  • byteio_ext

    Adds methods for reading/writing LEB128 compressed values from implementors of the traits in byteio. This feature does not require the std feature.

License

This project is dual-licensed under either of

at your option.

Dependencies

~48KB