Struct SliceArena

pub struct SliceArena<T = u8> { /* private fields */ }

Thread-safe memory arena.

Implementations

impl<T: Clone> SliceArena<T>

pub fn new() -> Self

New arena with ~64KB of initial capacity (which will grow exponentially as needed).

It works with any cloneable element type, but SliceArena<u8> is the default (it’s like Vec<u8>).

pub fn with_capacity(capacity: usize) -> Self

New arena with memory reserved for the initial number of elements.

Arena grows expomnentially, so once this capacity is exhausted, a double of that size will be allocated.

Capacity should be much much larger than sizes of slices pushed. Pushing a slice larger than the capacity leaves previous capacity unused.

pub fn push<'arena>(&'arena self, slice: &[T]) -> &'arena mut [T]

Copy a slice into the arena. Returns arena-allocated slice.

impl SliceArena<u8>

pub fn push_str<'arena>(&'arena self, s: impl AsRef<str>) -> &'arena str

Store a string slice in the arena.

pub fn push_os_str<'arena>(&'arena self, s: &OsStr) -> &'arena OsStr

Store a Unix OsStr in the arena. This function does not exist on Windows.

pub fn push_path<'arena>(&'arena self, str: impl AsRef<Path>) -> &'arena Path

Store a Unix Path in the arena. This function does not exist on Windows.