RustCrypto: hex-literal

此 crate 提供了 hex! 宏，用于在编译时将十六进制字符串字面量转换为字节数组。

它接受以下输入字符串中的字符

• '0'...'9'，'a'...'f'，'A'...'F' — 将用于输出字节数组构造的十六进制字符
• ' '，'\r'，'\n'，'\t' — 将被忽略的格式化字符

示例

use hex_literal::hex;

// The macro can be used in const contexts
const DATA: [u8; 4] = hex!("01020304");
assert_eq!(DATA, [1, 2, 3, 4]);

// Both upper and lower hex values are supported
assert_eq!(hex!("a1 b2 c3 d4"), [0xA1, 0xB2, 0xC3, 0xD4]);
assert_eq!(hex!("E5 E6 90 92"), [0xE5, 0xE6, 0x90, 0x92]);
assert_eq!(hex!("0a0B 0C0d"), [10, 11, 12, 13]);

// Multi-line literals
let bytes1 = hex!("
    00010203 04050607
    08090a0b 0c0d0e0f
");
assert_eq!(
    bytes1,
    [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
);

// It's possible to use several literals
// (results will be concatenated)
let bytes2 = hex!(
    "00010203 04050607" // first half
    "08090a0b 0c0d0e0f" // second half
);
assert_eq!(bytes1, bytes2);

在字面量中使用不支持字符会导致编译错误

hex_literal::hex!("АА"); // Cyrillic "А"
hex_literal::hex!("11　22"); // Japanese space

字面量中的注释不受支持

hex_literal::hex!("0123 // foo");

每个字面量必须包含偶数个十六进制字符

hex_literal::hex!(
    "01234"
    "567"
);

最低支持的 Rust 版本

Rust 1.57 或更高版本。

将来，我们保留更改 MSRV 的权利（即 MSRV 不在本 crate 的 SemVer 保证范围内），但是当我们这样做时，将伴随着小版本号的增加。

许可协议

根据您选择，许可协议为

• Apache 许可协议，版本 2.0
• MIT 许可协议

。

贡献

除非您明确声明，否则您根据Apache-2.0许可证定义的工作中任何有意提交的贡献，都应双重许可，如上所述，没有任何附加条款或条件。