based16 0.2.4

BASE-16(HEX) implementation for chads
Documentation 
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

extern crate alloc;

use crate::{DecodeError, CharTable, CHAR_TABLE_UPPER, CHAR_TABLE_LOWER};
use crate::{arch, required_encode_len, required_decode_len};

use alloc::vec::Vec;

fn hex_to_vec(table: CharTable, input: &[u8], out: &mut Vec<u8>) -> usize {
    let required_len = required_encode_len(input.len());
    out.reserve(required_len);

    let result = arch::hex(table, input, out.spare_capacity_mut());
    unsafe {
        out.set_len(out.len() + required_len);
    }

    result
}

#[inline(always)]
///Writes upper case hex appending to `out` vector
pub fn hex_upper_to_vec(input: &[u8], out: &mut Vec<u8>) -> usize {
    hex_to_vec(CHAR_TABLE_UPPER, input, out)
}

#[inline(always)]
///Writes lower case hex appending to `out` vector
pub fn hex_lower_to_vec(input: &[u8], out: &mut Vec<u8>) -> usize {
    hex_to_vec(CHAR_TABLE_LOWER, input, out)
}

#[inline(always)]
///Decodes hex-encoded `input` into `out`, truncating by its size, if necessary.
///
///On error, vector length remains unchanged, but capacity may be changed.
pub fn unhex_to_vec(input: &[u8], out: &mut Vec<u8>) -> Result<usize, DecodeError> {
    let required_len = required_decode_len(input.len());
    out.reserve(required_len);

    let result = arch::unhex(input, out.spare_capacity_mut())?;
    unsafe {
        out.set_len(out.len() + required_len);
    }

    Ok(result)
}