13 releases (7 breaking)

0.10.0 Sep 14, 2024
0.9.0 Nov 23, 2023
0.8.2 Nov 22, 2023
0.8.0 Jun 19, 2023
0.2.0 Nov 7, 2018

#8 in Value formatting

Download history 115142/week @ 2024-08-04 117058/week @ 2024-08-11 115487/week @ 2024-08-18 117490/week @ 2024-08-25 125692/week @ 2024-09-01 127497/week @ 2024-09-08 115484/week @ 2024-09-15 123560/week @ 2024-09-22 125884/week @ 2024-09-29 115276/week @ 2024-10-06 128668/week @ 2024-10-13 124235/week @ 2024-10-20 122479/week @ 2024-10-27 125275/week @ 2024-11-03 136287/week @ 2024-11-10 125483/week @ 2024-11-17

520,210 downloads per month
Used in 568 crates (100 directly)

MIT license

59KB
1.5K SLoC

faster-hex

License crate-badge

This program implements hex encoding a slice into a predetermined destination using various different instruction sets.

Benchmark

Running

Runs benchmark

cargo bench

Results

Machine: MacBook Pro (Early 2015) (2.7 GHz Intel Core i5)

Rust: rustc 1.31.0 (abe02cefd 2018-12-04)

Compare with hex:

  • Encoding ~10x over
  • Decoding ~10x over

Compare with rustc-hex:

  • Encoding ~2.5x over
  • Decoding ~7x over

Examples

Encode to hex

use faster_hex::hex_string;

let result = hex_string(b"Hello world!");
assert_eq!(result, "48656c6c6f20776f726c6421");

Encode to upper case hex

use faster_hex::hex_string_upper;

let result = hex_string_upper(b"Hello world!");
assert_eq!(result, "48656C6C6F20776F726C6421");

Decode

use faster_hex::hex_decode;

let src = b"48656c6c6f20776f726c6421";
let mut dst = vec![0; src.len() / 2];
hex_decode(src, &mut dst).unwrap();
assert_eq!(dst, b"Hello world!");

Decode with case check

use faster_hex::{hex_decode_with_case, CheckCase};

let src = b"48656c6c6f20776f726c6421";
let mut dst = vec![0; src.len() / 2];

assert!(hex_decode_with_case(src, &mut dst, CheckCase::Lower).is_ok());
assert_eq!(dst, b"Hello world!");

assert!(hex_decode_with_case(src, &mut dst, CheckCase::None).is_ok());
assert_eq!(dst, b"Hello world!");

assert!(hex_decode_with_case(src, &mut dst, CheckCase::Upper).is_err());

Serde feature


use serde::{Deserialize, Serialize};

#[derive(Debug, PartialEq, Eq, Serialize, Deserialize)]
struct Simple {
  #[serde(with = "faster_hex")]
  foo: Vec<u8>,
  #[serde(with = "faster_hex::nopfx_lowercase")]
  bar: Vec<u8>,
}

Notice

Major version zero (0.y.z) is for initial development. Anything MAY change at any time. The public API SHOULD NOT be considered stable.

MINOR version when make incompatible API changes before 1.0.0.

License

This project is licensed under the MIT license.

Third party software

This product includes copies and modifications of software developed by third parties:

See the source code files for more details.

Copies of third party licenses can be found in LICENSE-THIRD-PARTY.

Dependencies

~105–435KB