Add MultitraitObject implementation

Signed-off-by: trivernis <trivernis@protonmail.com>
main
trivernis 2 years ago
commit d3baa40c9b
Signed by: Trivernis
GPG Key ID: DFFFCC2C7A02DB45

2
.gitignore vendored

@ -0,0 +1,2 @@
/target
Cargo.lock

8
.idea/.gitignore vendored

@ -0,0 +1,8 @@
# Default ignored files
/shelf/
/workspace.xml
# Editor-based HTTP Client requests
/httpRequests/
# Datasource local storage ignored files
/dataSources/
/dataSources.local.xml

@ -0,0 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="DiscordProjectSettings">
<option name="show" value="ASK" />
<option name="description" value="" />
</component>
</project>

@ -0,0 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="ProjectModuleManager">
<modules>
<module fileurl="file://$PROJECT_DIR$/.idea/multi-trait-object.iml" filepath="$PROJECT_DIR$/.idea/multi-trait-object.iml" />
</modules>
</component>
</project>

@ -0,0 +1,11 @@
<?xml version="1.0" encoding="UTF-8"?>
<module type="CPP_MODULE" version="4">
<component name="NewModuleRootManager">
<content url="file://$MODULE_DIR$">
<sourceFolder url="file://$MODULE_DIR$/src" isTestSource="false" />
<excludeFolder url="file://$MODULE_DIR$/target" />
</content>
<orderEntry type="inheritedJdk" />
<orderEntry type="sourceFolder" forTests="false" />
</component>
</module>

@ -0,0 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="VcsDirectoryMappings">
<mapping directory="$PROJECT_DIR$" vcs="Git" />
</component>
</project>

@ -0,0 +1,9 @@
[package]
name = "multi-trait-object"
version = "0.1.0"
edition = "2021"
# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
[dev-dependencies]
dyn-clone = "1.0.4"

@ -0,0 +1,47 @@
# Multitrait Object
This crate provides a pointer type that allows casting into
all registered traits for a given type.
This is done by storing the pointer to the v-table for each
trait implementation on the type as well as the pointer to the
data.
## Usage
```rust
use multi_trait_object::prelude::*;
use std::fmt::Debug;
#[derive(Debug)]
struct MyStruct {
a: u64,
}
trait MyTrait {}
trait MyOtherTrait {}
impl MyTrait for MyStruct{}
impl MyOtherTrait for MyStruct {}
impl_trait_object!(MyStruct, dyn MyTrait, dyn MyOtherTrait, dyn Debug);
fn main() {
let obj = MyStruct {
a: 5
};
let mto = obj.into_multitrait();
{
let debug = mto.downcast_trait::<dyn Debug>().unwrap();
println!("{:?}", debug);
let my_trait = mto.downcast_trait::<dyn MyTrait>().unwrap();
}
let trait_box: Box<dyn MyTrait> = mto.downcast_trait_boxed::<dyn MyTrait>().unwrap();
}
```
## License
Apache-2.0

@ -0,0 +1,166 @@
#![doc=include_str!("../README.md")]
#[cfg(test)]
mod tests;
pub(crate) mod macros;
use std::any::{Any, TypeId};
use std::collections::HashMap;
#[doc(hidden)]
#[derive(Copy, Clone, Debug)]
#[repr(C)]
pub struct FatPointer {
pub data: *const (),
pub vptr: *const (),
}
/// A container to store data with the associated type and trait objects
/// allowing for casting down to traits or the concrete type
/// ```rust
/// use multi_trait_object::prelude::*;
/// use std::fmt::{Debug, Display};
///
/// let mut mto = MultitraitObject::new(String::new());
/// register_traits!(mto, String, dyn Debug, dyn Display);
///
/// let debug = mto.downcast_trait::<dyn Debug>().unwrap();
/// println!("{:?}", debug);
/// let display = mto.downcast_trait::<dyn Display>().unwrap();
/// println!("{}", display);
/// let string = mto.downcast::<String>().unwrap();
/// println!("{}", string);
/// ```
#[derive(Debug)]
pub struct MultitraitObject {
pub data: *mut (),
pub original_typeid: TypeId,
pub any_vtable: *const (),
pub traits: HashMap<TypeId, *const ()>,
}
impl MultitraitObject {
pub fn new<T: 'static + Any>(value: T) -> Self {
let any_vtable = __fat_pointer!(T as dyn Any).vptr;
let data = Box::into_raw(Box::new(value)) as *mut ();
let mut this = Self {
data,
any_vtable,
original_typeid: TypeId::of::<T>(),
traits: Default::default(),
};
this._register::<dyn Any>(any_vtable);
this
}
/// Downcasts the object into a reference of the given trait
pub fn downcast_trait<T1: 'static + ?Sized>(&self) -> Option<&T1> {
if std::mem::size_of::<&T1>() != std::mem::size_of::<FatPointer>() {
None
} else {
unsafe {
self._downcast_trait::<T1>()
}
}
}
/// Downcasts the object into a mutable reference of the given trait
pub fn downcast_trait_mut<T1: 'static + ?Sized>(&mut self) -> Option<&mut T1> {
if std::mem::size_of::<&T1>() != std::mem::size_of::<FatPointer>() {
None
} else {
unsafe {
self._downcast_trait_mut::<T1>()
}
}
}
/// Downcasts the object to a boxed representation of the given trait
pub fn downcast_trait_boxed<T1: 'static + ?Sized>(mut self) -> Option<Box<T1>> {
if std::mem::size_of::<&T1>() != std::mem::size_of::<FatPointer>() {
None
} else {
unsafe {
self._downcast_boxed_trait::<T1>()
}
}
}
/// Downcasts the object into a reference of the given type
pub fn downcast_ref<T: Any>(&self) -> Option<&T> {
let any = self.downcast_trait::<dyn Any>().unwrap();
any.downcast_ref::<T>()
}
/// Downcasts the object into a mutable reference of the given type
pub fn downcast_mut<T: Any>(&mut self) -> Option<&mut T> {
let any = self.downcast_trait_mut::<dyn Any>().unwrap();
any.downcast_mut::<T>()
}
/// Downcasts the object into the given concrete type
pub fn downcast<T: Any>(self) -> Option<T> {
if TypeId::of::<T>() == self.original_typeid {
unsafe {
let typed_ptr = std::mem::transmute::<_, *mut T>(self.data);
let boxed = Box::from_raw(typed_ptr);
Some(*boxed)
}
} else {
None
}
}
#[doc(hidden)]
pub fn _register<T2: 'static + ?Sized>(&mut self, vtable_ptr: *const ()) {
self.traits.insert(TypeId::of::<T2>(), vtable_ptr);
}
#[doc(hidden)]
unsafe fn _downcast_trait<T1: 'static + ?Sized>(&self) -> Option<&T1> {
let vptr = *self.traits.get(&TypeId::of::<T1>())?;
let fat_pointer = FatPointer { data: self.data, vptr };
let value = std::mem::transmute::<_, &&T1>(&fat_pointer);
Some(*value)
}
#[doc(hidden)]
unsafe fn _downcast_trait_mut<T1: 'static + ?Sized>(&mut self) -> Option<&mut T1> {
let vptr = *self.traits.get(&TypeId::of::<T1>())?;
let mut fat_pointer = FatPointer { data: self.data, vptr };
let value = std::mem::transmute::<_, &mut &mut T1>(&mut fat_pointer);
Some(*value)
}
#[doc(hidden)]
unsafe fn _downcast_boxed_trait<T1: 'static + ?Sized>(&mut self) -> Option<Box<T1>> {
let vptr = *self.traits.get(&TypeId::of::<T1>())?;
let fat_pointer = FatPointer { data: self.data, vptr };
let value = std::mem::transmute::<_, *const *mut T1>(&fat_pointer);
let value = Box::from_raw(*value);
Some(value)
}
}
impl Drop for MultitraitObject {
fn drop(&mut self) {
unsafe {
let raw = Box::from_raw(self.data);
std::mem::drop(raw);
}
}
}
pub trait IntoMultitrait {
fn into_multitrait(self) -> MultitraitObject;
}
pub mod prelude {
pub use crate::*;
}

@ -0,0 +1,61 @@
/// Implements the `IntoMultitrait` trait on the defined type.
/// ```rust
/// use multi_trait_object::prelude::*;
///
/// struct MyStruct {
/// a: u64,
/// }
///
/// trait MyTrait {}
/// trait MyOtherTrait {}
///
/// impl MyTrait for MyStruct{}
/// impl MyOtherTrait for MyStruct {}
///
/// impl_trait_object!(MyStruct, dyn MyTrait, dyn MyOtherTrait);
/// ```
#[macro_export]
macro_rules! impl_trait_object {
($obj:ty, $($trt:ty),*) => {
impl IntoMultitrait for $obj {
fn into_multitrait(self) -> MultitraitObject {
let mut mto = MultitraitObject::new(self);
$(
register_traits!(mto, $obj, $trt);
)*
mto
}
}
}
}
/// Registers multiple traits on a multitrait object
/// ```rust
/// use multi_trait_object::prelude::*;
/// use std::fmt::{Debug, Display};
///
/// let value = String::new();
/// let mut mto = MultitraitObject::new(value);
/// register_traits!(mto, String, dyn Debug, dyn Display);
/// ```
#[macro_export]
macro_rules! register_traits {
($r:expr, $v:ty, $($t:ty), +) => {
$(
$r._register::<$t>(__fat_pointer!($v as $t).vptr);
)+
}
}
#[doc(hidden)]
#[macro_export]
macro_rules! __fat_pointer {
($v:ty as $t:ty) => {{
let x = ::std::ptr::null::<$v>() as *const $v as *const $t;
#[allow(unused_unsafe)]
unsafe {
std::mem::transmute::<_, FatPointer>(x)
}
}}
}

@ -0,0 +1,82 @@
use dyn_clone::{clone_box, DynClone};
use std::fmt::Debug;
use crate::prelude::*;
#[derive(Clone, Debug)]
struct TestStruct {
a: u32,
test: String,
}
impl Default for TestStruct {
fn default() -> Self {
Self {
a: 5,
test: String::from("Hello World"),
}
}
}
trait ChangeStruct {
fn update(&mut self);
}
impl ChangeStruct for TestStruct {
fn update(&mut self) {
self.a = 6;
}
}
impl_trait_object!(TestStruct, dyn DynClone, dyn ChangeStruct, dyn Debug);
#[test]
fn it_creates_fat_pointers() {
let debug_vtable1 = __fat_pointer!(TestStruct as dyn Debug).vptr;
let dclone_vtable1 = __fat_pointer!(TestStruct as dyn DynClone).vptr;
let debug_vtable2 = __fat_pointer!(TestStruct as dyn Debug).vptr;
assert_eq!(debug_vtable1, debug_vtable2);
let dclone_vtable2 = __fat_pointer!(TestStruct as dyn DynClone).vptr;
assert_eq!(dclone_vtable1, dclone_vtable2);
}
#[test]
fn it_constructs() {
TestStruct::default().into_multitrait();
}
#[test]
fn it_downcasts_traits() {
let mto = TestStruct::default().into_multitrait();
let debug = mto.downcast_trait::<dyn Debug>().unwrap();
let _ = format!("{:?}", debug);
let obj = mto.downcast_trait::<dyn DynClone>().unwrap();
let _new_obj = clone_box(&*obj);
}
#[test]
fn it_downcasts_trait_mutable() {
let mut mto = TestStruct::default().into_multitrait();
let change_struct = mto.downcast_trait_mut::<dyn ChangeStruct>().unwrap();
change_struct.update();
}
#[test]
fn it_downcasts_boxed_traits() {
let mto = TestStruct::default().into_multitrait();
let boxed = mto.downcast_trait_boxed::<dyn Debug>().unwrap();
let _ = format!("{:?}", boxed);
}
#[test]
fn it_downcasts_to_original() {
let mut mto = TestStruct::default().into_multitrait();
{
mto.downcast_ref::<TestStruct>().unwrap();
}
{
mto.downcast_mut::<TestStruct>().unwrap();
}
let result = mto.downcast::<TestStruct>().unwrap();
assert_eq!(result.a, 5);
assert_eq!(result.test, String::from("Hello World"));
}
Loading…
Cancel
Save