Struct SafeVec 

pub struct SafeVec<T> { /* private fields */ }

Safe wrapper around vectors with bounds checking

Implementations

impl<T> SafeVec<T>

pub fn new() -> Self

Create a new safe vector with bounds checking enabled

pub fn with_capacity(capacity: usize) -> Self

Create a safe vector with specified capacity

pub fn from_vec(vec: Vec<T>) -> Self

Create from existing vector

pub fn disable_bounds_check(self) -> Self

Disable bounds checking for performance (unsafe)

pub fn get(&self, index: usize) -> UtilsResult<&T>

Safe get with bounds checking

pub fn get_mut(&mut self, index: usize) -> UtilsResult<&mut T>

Safe mutable get with bounds checking

pub fn safe_slice(&self, start: usize, end: usize) -> UtilsResult<&[T]>

Safe slice access

pub fn push(&mut self, item: T)

Push element

pub fn pop(&mut self) -> Option<T>

Pop element

pub fn len(&self) -> usize

Get length

pub fn is_empty(&self) -> bool

Check if empty

pub fn capacity(&self) -> usize

Get capacity

pub fn reserve(&mut self, additional: usize)

Reserve additional capacity

pub unsafe fn as_vec(&self) -> &Vec<T>

Access underlying vector (unsafe)

Safety

This function exposes the underlying Vec<T> directly, bypassing all bounds checking and overflow protection mechanisms. The caller must ensure that any modifications to the returned vector do not violate the buffer’s safety guarantees and internal invariants.

pub fn into_vec(self) -> Vec<T>

Convert to vector

Trait Implementations

impl<T: Clone> Clone for SafeVec<T>

fn clone(&self) -> SafeVec<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for SafeVec<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T> Default for SafeVec<T>

fn default() -> Self

Returns the “default value” for a type.