TAny is a library that provides container TAny as drop-in replacement for Box<dyn Any>.
It is designed to avoid allocations when value fits into the storage.
Currently size of the storage is 3 times usize and max alignment is 8 bytes.
If size or alignment of the value is greater than the storage, it is allocated on heap and boxed.
use tany::TAny;
// u32 fits inline storage, so no allocation is performed.
let a: TAny = TAny::new(42u32);
// Get reference to the value.
let r: &u32 = a.downcast_ref::<u32>().unwrap();
// Get reference to the value.
let r: &mut u32 = a.downcast_mut::<u32>().unwrap();
// Take ownership of the value.
let a: u32 = a.downcast::<u32>().unwrap();
let already_boxed = Box::new([1u32; 10]);
// Construct TAny from already boxed value.
// If type doesn't fit into the storage, the box is used as is,
// otherwise value is unboxed.
let a: TAny = TAny::from_box(already_boxed);
assert_eq!(a.downcast_ref::<[u32; 10]>().unwrap(), &[1u32; 10]);
let any: Box<dyn Any + Send + Sync> = Box::new(42u32);
// Construct TAny from existing Box<dyn Any>.
let a: TAny = TAny::from_any(any); // Or use `From<Box<dyn Any + Send + Sync>>` trait.
assert_eq!(a.downcast_ref::<u32>().unwrap(), &42);TAny requires types to implement Send and Sync.
And in turn, TAny is Send and Sync itself.
For non-Send and non-Sync types, tany crate provides LTAny type with all the same API as TAny,
except there's no Send and Sync bounds.