[−][src]Crate better_any
Better Any
Rust RFC for non_static_type_id
feature has been reverted.
Which means in foreseeable future there will be no built-in way in rust to get type id for non-static type
let alone safely use it to downcast to a particular type.
This crate provides tools to do these things safely for types with single lifetime. Although looks like it is technically possible to extend this approach for multiple lifetimes, consistent api and derive macro would be much harder to create and use because of the necessity to properly handle lifetime relations. Feel free to create an issue if you have actual use case where you need this functionality for multiple lifetimes.
Also it has better downcasting that allows you do downcast not just from dyn Tid
(like dyn Any
) but from
any trait object that implements Tid
.
So there is no more need to extend your traits with fn to_any(&self)-> &dyn Any
MSRV: 1.41.0-stable
Usage
Basically in places where before you have used dyn Any
you can use dyn Tid<'a>
- If your type is generic you should derive
Tid
implementation for it withTid
derive macro. Then to retrieve back concrete type<dyn Tid>::downcast_*
methods should be used. - If your type is not generic/implements Any you can create
dyn Any
and convert it todyn Tid
. Then to retrieve back concrete type<dyn Tid>::downcast_any_*
methods should be used - If your type is not generic and local to your crate you also can derive
Tid
but then you need to be careful to use methods that corresponds to the way you createdyn Tid
for that particular type. Otherwise downcasting will returnNone
.
If all your types can implement Tid
to avoid confusion
recommended way is to use first option even if some types implement Any
.
If there are some types that implement Any
and can't implement Tid
(i.e. types from other library),
recommended way is to use second option for all types that implement Any
to reduce confusion to minimum.
Interoperability with Any
Unfortunately you can't just use Tid
everywhere because currently it is impossible
to implement Tid
for T:Any
since it would conflict with any other possible Tid
implementation.
To overcome this limitation there is a From
impl to go from dyn Any
to dyn Tid
But Any
and Tid
deliberately return different type ids because otherwise Type<'a>
and Type<'static>
would be indistinguishable and it would allow to go from Type<'static>
to Type<'a>
via dyn Tid
which is obviously unsound for invariant and contravariant structs.
Although if you are using dyn Trait
where Trait:Tid
all of this wouldn't work,
and you are left with Tid
only.
Safety
It is safe because created trait object preserve lifetime information,
thus allowing us to safely downcast with proper lifetime.
Otherwise internally it is plain old Any
.
Macros
type_id | Simple version of derive macro to not pull all proc macro dependencies in simple cases when all structs are not generic |
Traits
Tid | This trait indicates that this type can be converted to
trait object with typeid while preserving lifetime information.
Extends |
TidAble | This trait indicates that you can substitute this type as a type parameter to
another type so that resulting type could implement |
TidExt | Extension trait that contains actual downcasting methods. |
Functions
typeid_of | Returns type id of |
Attribute Macros
impl_tid | Attribute macro that makes your implementation of |
Derive Macros
Tid | Derive macro to implement traits from this crate |