Crate hex_str

Handle and parse hex strings of specific length.

Example hex string, an md5 of an empty file:

d41d8cd98f00b204e9800998ecf8427e

Example:

use hex_str::HexString;

let s = "d41d8cd98f00b204e9800998ecf8427e";
let v = HexString::<16>::try_parse(s).unwrap();

assert_eq!(v, "d41d8cd98f00b204e9800998ecf8427e");

Feature flags:

• serde - adds the ability to serialize and deserialize a HexString using serde.
• rand - adds implementation of rand’s Standard distribution, which enables random generation of HexString’s directly.

Using serde feature:

#[cfg(feature = "serde")]
{
    use hex_str::HexString;
    use serde::{Deserialize, Serialize};

    #[derive(Deserialize, Serialize)]
    struct Example {
        md5: HexString<16>,
    }

    let s = r#"
    {
        "md5": "d41d8cd98f00b204e9800998ecf8427e"
    }
    "#;

    let example: Example = serde_json::from_str(s).unwrap();
    assert_eq!(example.md5, "d41d8cd98f00b204e9800998ecf8427e");

    serde_json::to_string(&example).unwrap();
}

Using rand feature:

#[cfg(feature = "rand")]
{
    use hex_str::HexString;

    let _: HexString<16> = rand::random();
}

Structs

• HexString
  A hex string of specific length

Enums

• Error
  An error that may occur when parsing hex strings