base64-ng 2.0.1

no_std-first Base64 encoding and decoding with strict RFC 4648 APIs and optional SIMD
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

//! Fallible allocating WHATWG forgiving decode operations.

use alloc::vec::Vec;

use super::{ForgivingBase64, ForgivingError};

impl ForgivingBase64 {
    /// Decodes a web string into a newly allocated byte vector.
    pub fn decode_to_vec(self, input: &str) -> Result<Vec<u8>, ForgivingError> {
        self.decode_to_vec_with_limit(input, usize::MAX)
    }

    /// Decodes subject to an exact caller-selected output limit.
    pub fn decode_to_vec_with_limit(
        self,
        input: &str,
        max_output_len: usize,
    ) -> Result<Vec<u8>, ForgivingError> {
        let required = self.decoded_len(input)?;
        if required > max_output_len {
            return Err(ForgivingError::AllocationLimitExceeded {
                required,
                limit: max_output_len,
            });
        }
        let mut output = Vec::new();
        output
            .try_reserve_exact(required)
            .map_err(|_| ForgivingError::AllocationFailed {
                requested: required,
            })?;
        output.resize(required, 0);
        self.decode_into(input, &mut output)?;
        Ok(output)
    }
}