basekit 0.5.0

Universal library for encoding in various bases
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
47
48
49
50
51
52
53
54
55
56
57
58

use super::super::config::Base64EncodeConfig;
use super::super::error::Base64Error;
use super::encode_full_groups_into::encode_full_groups_into;
use super::encode_tail_into::encode_tail_into;

#[inline]
pub fn encode64_into(
    config: &Base64EncodeConfig,
    dst: &mut [u8],
    src: &[u8],
) -> Result<usize, Base64Error> {
    if src.is_empty() {
        return Ok(0);
    }

    let full_groups_count = src.len() / 3;
    let remainder = src.len() % 3;

    let tail_output_len = match (remainder, config.padding.is_some()) {
        (0, _) => 0,
        (1, true) => 4,
        (1, false) => 2,
        (2, true) => 4,
        (2, false) => 3,
        _ => unreachable!(),
    };

    let output_len = full_groups_count * 4 + tail_output_len;

    if dst.len() < output_len {
        return Err(Base64Error::DestinationBufferTooSmall {
            needed: output_len,
            provided: dst.len(),
        });
    }

    let mut dst_offset = 0usize;

    if full_groups_count > 0 {
        dst_offset += encode_full_groups_into(
            config,
            &mut dst[..full_groups_count * 4],
            &src[..full_groups_count * 3],
        )?;
    }

    if remainder > 0 {
        dst_offset += unsafe {
            encode_tail_into(
                config,
                &mut dst[dst_offset..],
                &src[full_groups_count * 3..],
            )?
        };
    }

    Ok(dst_offset)
}