#![cfg(feature = "rle")]
const DANGEROUS_CAPACITY: usize = 16_777_216;
#[derive(Debug)]
pub enum Error {
TryReserve,
Dangerous,
}
pub type Result<T, E = Error> = std::result::Result<T, E>;
pub fn guarded_alloc(
capacity: usize,
encapsulated_size: usize,
ratio_threshold: u32,
) -> Result<Vec<u8>> {
if capacity >= DANGEROUS_CAPACITY && encapsulated_size < capacity / ratio_threshold as usize {
return Err(Error::Dangerous);
}
let mut out = Vec::new();
out.try_reserve_exact(capacity)
.map_err(|_| Error::TryReserve)?;
Ok(out)
}
pub fn guarded_reserve(
out: &mut Vec<u8>,
additional_capacity: usize,
encapsulated_size: usize,
ratio_threshold: u32,
) -> Result<()> {
if additional_capacity >= DANGEROUS_CAPACITY
&& encapsulated_size < additional_capacity / ratio_threshold as usize
{
return Err(Error::Dangerous);
}
out.try_reserve_exact(additional_capacity)
.map_err(|_| Error::TryReserve)?;
Ok(())
}
pub fn guarded_resize(
out: &mut Vec<u8>,
additional_capacity: usize,
encapsulated_size: usize,
ratio_threshold: u32,
) -> Result<()> {
guarded_reserve(out, additional_capacity, encapsulated_size, ratio_threshold)?;
out.resize(out.len() + additional_capacity, 0);
Ok(())
}