1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
use crate::{decode_inner, encoded_len, Error};
#[cfg(feature = "alloc")]
use crate::{decoded_len, String, Vec};
/// Decode an upper Base16 (hex) string into the provided destination buffer.
pub fn decode(src: impl AsRef<[u8]>, dst: &mut [u8]) -> Result<&[u8], Error> {
decode_inner(src.as_ref(), dst, decode_nibble)
}
/// Decode an upper Base16 (hex) string into a byte vector.
#[cfg(feature = "alloc")]
#[cfg_attr(docsrs, doc(cfg(feature = "alloc")))]
pub fn decode_vec(input: impl AsRef<[u8]>) -> Result<Vec<u8>, Error> {
let mut output = vec![0u8; decoded_len(input.as_ref())?];
decode(input, &mut output)?;
Ok(output)
}
/// Encode the input byte slice as upper Base16.
///
/// Writes the result into the provided destination slice, returning an
/// ASCII-encoded upper Base16 (hex) string value.
pub fn encode<'a>(src: &[u8], dst: &'a mut [u8]) -> Result<&'a [u8], Error> {
let dst = dst
.get_mut(..encoded_len(src))
.ok_or(Error::InvalidLength)?;
for (src, dst) in src.iter().zip(dst.chunks_exact_mut(2)) {
dst[0] = encode_nibble(src >> 4);
dst[1] = encode_nibble(src & 0x0f);
}
Ok(dst)
}
/// Encode input byte slice into a [`&str`] containing upper Base16 (hex).
pub fn encode_str<'a>(src: &[u8], dst: &'a mut [u8]) -> Result<&'a str, Error> {
encode(src, dst).map(|r| unsafe { core::str::from_utf8_unchecked(r) })
}
/// Encode input byte slice into a [`String`] containing upper Base16 (hex).
///
/// # Panics
/// If `input` length is greater than `usize::MAX/2`.
#[cfg(feature = "alloc")]
#[cfg_attr(docsrs, doc(cfg(feature = "alloc")))]
pub fn encode_string(input: &[u8]) -> String {
let elen = encoded_len(input);
let mut dst = vec![0u8; elen];
let res = encode(input, &mut dst).expect("dst length is correct");
debug_assert_eq!(elen, res.len());
unsafe { crate::String::from_utf8_unchecked(dst) }
}
/// Decode a single nibble of upper hex
#[inline(always)]
fn decode_nibble(src: u8) -> u16 {
// 0-9 0x30-0x39
// A-F 0x41-0x46 or a-f 0x61-0x66
let byte = src as i16;
let mut ret: i16 = -1;
// 0-9 0x30-0x39
// if (byte > 0x2f && byte < 0x3a) ret += byte - 0x30 + 1; // -47
ret += (((0x2fi16 - byte) & (byte - 0x3a)) >> 8) & (byte - 47);
// A-F 0x41-0x46
// if (byte > 0x40 && byte < 0x47) ret += byte - 0x41 + 10 + 1; // -54
ret += (((0x40i16 - byte) & (byte - 0x47)) >> 8) & (byte - 54);
ret as u16
}
/// Encode a single nibble of hex
#[inline(always)]
fn encode_nibble(src: u8) -> u8 {
let mut ret = src as i16 + 0x30;
// 0-9 0x30-0x39
// A-F 0x41-0x46
ret += ((0x39i16 - ret) >> 8) & (0x41i16 - 0x3a);
ret as u8
}
|
