Struct stack_any::StackAny

pub struct StackAny<const N: usize> { /* private fields */ }

A convertible type that owns a stack allocation of N size.

Implementations

impl<const N: usize> StackAny<N>

pub fn new<T>(value: T) -> Self

where T: Any,

Allocates N-size memory on the stack and then places value into it.

Panics

Panics if T size is larger than N.

Examples

let five = stack_any::StackAny::<{ std::mem::size_of::<i32>() }>::new(5);

pub fn try_new<T>(value: T) -> Option<Self>

where T: Any,

Allocates N-size memory on the stack and then places value into it. Returns None if T size is larger than N.

Examples

let five = stack_any::StackAny::<{ std::mem::size_of::<i32>() }>::try_new(5);

pub fn downcast_ref<T>(&self) -> &T

where T: Any,

Attempt to return reference to the inner value as a concrete type.

Panics

Panics if T size is larger than N.

Examples

let five = stack_any::stack_any!(i32, 5);
assert_eq!(five.downcast_ref::<i32>(), &5);

pub fn try_downcast_ref<T>(&self) -> Option<&T>

where T: Any,

Attempt to return reference to the inner value as a concrete type. Returns None if T size is larger than N.

Examples

let five = stack_any::stack_any!(i32, 5);
assert_eq!(five.try_downcast_ref::<i32>(), Some(&5));
assert_eq!(five.try_downcast_ref::<i64>(), None);

pub fn downcast_mut<T>(&mut self) -> &mut T

where T: Any,

Attempt to return mutable reference to the inner value as a concrete type.

Panics

Panics if T size is larger than N.

Examples

let mut five = stack_any::stack_any!(i32, 5);
assert_eq!(five.downcast_mut::<i32>(), &mut 5);

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

where T: Any,

Attempt to return mutable reference to the inner value as a concrete type. Returns None if T size is larger than N.

Examples

let mut five = stack_any::stack_any!(i32, 5);
assert_eq!(five.try_downcast_mut::<i32>(), Some(&mut 5));
assert_eq!(five.try_downcast_mut::<i64>(), None);

pub fn downcast<T>(self) -> T

where T: Any,

Attempt to downcast the stack to a concrete type.

Panics

Panics if T size is larger than N.

Examples

let five = stack_any::stack_any!(i32, 5);
assert_eq!(five.downcast::<i32>(), 5);

pub fn try_downcast<T>(self) -> Option<T>

where T: Any,

Attempt to downcast the stack to a concrete type. Returns None if T size is larger than N.

Examples

let five = stack_any::stack_any!(i32, 5);
assert_eq!(five.try_downcast::<i32>(), Some(5));

Trait Implementations

impl<const N: usize> Debug for StackAny<N>

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

Formats the value using the given formatter.