Struct AnyVec 

pub struct AnyVec { /* private fields */ }

A type-erased vector that stores values of a single type.

AnyVec enables storing and retrieving vectors of any type that implements Send + Sync without knowing the type at compile time. It uses a function pointer for type-specific drop semantics and TypeId for runtime type verification.

Type Erasure Pattern

Values are stored behind a trait object and retrieved via type-safe downcasting. The get::<T>() method verifies the type at runtime before returning a slice reference.

Smart Pointer Types

The module provides two smart pointer types for vector access:

• AnyVecRef - Immutable reference to a Vec<T>
• AnyVecMutRef - Mutable reference to a Vec<T>

Examples

use any_container::AnyVec;

let mut vec = AnyVec::new::<i32>();
assert!(vec.is_empty());

vec.get_mut::<i32>().unwrap().push(42);
assert_eq!(vec.len(), 1);

assert_eq!(vec.get::<i32>().unwrap(), &[42]);
assert!(vec.get::<f64>().is_none()); // Type mismatch returns None

Implementations

impl AnyVec

pub fn new<T: 'static + Send + Sync>() -> Self

Creates a new empty AnyVec for elements of type T.

pub fn new_with_capacity<T: 'static + Send + Sync>(capacity: usize) -> Self

Creates a new AnyVec with the specified capacity for elements of type T.

pub fn from_vec<T: 'static + Send + Sync>(vec: Vec<T>) -> Self

Creates a new AnyVec from a Vec<T>, consuming the vector and taking ownership of its memory.

pub fn elem_type_id(&self) -> TypeId

Returns the type id of the elements stored in the AnyVec.

pub fn type_name(&self) -> &'static str

Returns the type name of the elements stored in the AnyVec.

pub fn get<T: 'static>(&self) -> Option<&[T]>

Returns a reference to the elements in the AnyVec as a slice of type T. Returns None if the stored type doesn’t match T.

pub unsafe fn get_unchecked<T: 'static>(&self) -> &[T]

Returns a reference to the elements in the AnyVec as a slice of type T.

Safety

The caller must ensure that the type T matches the type of the elements stored in the AnyVec. If the type is different, this can lead to undefined behaviour.

pub fn get_ref<T: 'static>(&self) -> Option<AnyVecRef<'_, T>>

Returns a smart pointer, dereferencing to a Vec<T>, allowing access to the elements in the AnyVec as a vector of type T.

Note

In most cases, you want AnyVec::get or AnyVec::get_mut instead.

pub unsafe fn get_ref_unchecked<T: 'static>(&self) -> AnyVecRef<'_, T>

Returns a smart pointer, dereferencing to a Vec<T>, allowing access to the elements in the AnyVec as a vector of type T.

Note

In most cases, you want AnyVec::get_unchecked or AnyVec::get_mut_unchecked instead.

Safety

The caller must ensure that the type T matches the type of the elements stored in the AnyVec. If the type is different, this can lead to undefined behaviour.

pub fn get_mut<T: 'static>(&mut self) -> Option<AnyVecMutRef<'_, T>>

Returns a smart pointer, dereferencing to a mutable Vec<T>, allowing access to the elements in the AnyVec as a mutable vector of type T.

pub unsafe fn get_mut_unchecked<T: 'static>(&mut self) -> AnyVecMutRef<'_, T>

Returns a smart pointer, dereferencing to a mutable Vec<T>, allowing access to the elements in the AnyVec as a mutable vector of type T.

Safety

The caller must ensure that the type T matches the type of the elements stored in the AnyVec. If the type is different, this can lead to undefined behaviour.

pub fn len(&self) -> usize

Returns the number of elements in the AnyVec.

pub fn is_empty(&self) -> bool

Returns true if the AnyVec contains no elements.

pub fn try_into_vec<T: 'static>(self) -> Result<Vec<T>, Self>

Consumes the AnyVec and returns the elements as a Vec<T>.

pub unsafe fn into_vec_unchecked<T: 'static>(self) -> Vec<T>

Consumes the AnyVec and returns the elements as a Vec<T>.

Safety

The caller must ensure that the type T matches the type of the elements stored in the AnyVec. If the type is different, this can lead to undefined behaviour.

Trait Implementations

impl Debug for AnyVec

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

Formats the value using the given formatter.

impl Drop for AnyVec

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Send for AnyVec

impl Sync for AnyVec