diff options
Diffstat (limited to 'vendor/dyn-clone/src')
| -rw-r--r-- | vendor/dyn-clone/src/lib.rs | 215 | ||||
| -rw-r--r-- | vendor/dyn-clone/src/macros.rs | 121 |
2 files changed, 0 insertions, 336 deletions
diff --git a/vendor/dyn-clone/src/lib.rs b/vendor/dyn-clone/src/lib.rs deleted file mode 100644 index e35e1089..00000000 --- a/vendor/dyn-clone/src/lib.rs +++ /dev/null @@ -1,215 +0,0 @@ -//! [![github]](https://github.com/dtolnay/dyn-clone) [![crates-io]](https://crates.io/crates/dyn-clone) [![docs-rs]](https://docs.rs/dyn-clone) -//! -//! [github]: https://img.shields.io/badge/github-8da0cb?style=for-the-badge&labelColor=555555&logo=github -//! [crates-io]: https://img.shields.io/badge/crates.io-fc8d62?style=for-the-badge&labelColor=555555&logo=rust -//! [docs-rs]: https://img.shields.io/badge/docs.rs-66c2a5?style=for-the-badge&labelColor=555555&logo=docs.rs -//! -//! <br> -//! -//! This crate provides a [`DynClone`] trait that can be used in trait objects, -//! and a [`clone_box`] function that can clone any sized or dynamically sized -//! implementation of `DynClone`. Types that implement the standard library's -//! [`std::clone::Clone`] trait are automatically usable by a `DynClone` trait -//! object. -//! -//! # Example -//! -//! ``` -//! use dyn_clone::DynClone; -//! -//! trait MyTrait: DynClone { -//! fn recite(&self); -//! } -//! -//! impl MyTrait for String { -//! fn recite(&self) { -//! println!("{} ♫", self); -//! } -//! } -//! -//! fn main() { -//! let line = "The slithy structs did gyre and gimble the namespace"; -//! -//! // Build a trait object holding a String. -//! // This requires String to implement MyTrait and std::clone::Clone. -//! let x: Box<dyn MyTrait> = Box::new(String::from(line)); -//! -//! x.recite(); -//! -//! // The type of x2 is a Box<dyn MyTrait> cloned from x. -//! let x2 = dyn_clone::clone_box(&*x); -//! -//! x2.recite(); -//! } -//! ``` -//! -//! This crate includes a macro for concisely implementing `impl -//! std::clone::Clone for Box<dyn MyTrait>` in terms of `dyn_clone::clone_box`. -//! -//! ``` -//! # use dyn_clone::DynClone; -//! # -//! // As before. -//! trait MyTrait: DynClone { -//! /* ... */ -//! } -//! -//! dyn_clone::clone_trait_object!(MyTrait); -//! -//! // Now data structures containing Box<dyn MyTrait> can derive Clone: -//! #[derive(Clone)] -//! struct Container { -//! trait_object: Box<dyn MyTrait>, -//! } -//! ``` -//! -//! The `clone_trait_object!` macro expands to just the following, which you can -//! handwrite instead if you prefer: -//! -//! ``` -//! # use dyn_clone::DynClone; -//! # -//! # trait MyTrait: DynClone {} -//! # -//! impl Clone for Box<dyn MyTrait> { -//! fn clone(&self) -> Self { -//! dyn_clone::clone_box(&**self) -//! } -//! } -//! -//! // and similar for Box<dyn MyTrait + Send>, Box<dyn MyTrait + Sync>, Box<dyn MyTrait + Send + Sync> -//! ``` - -#![doc(html_root_url = "https://docs.rs/dyn-clone/1.0.19")] -#![no_std] -#![allow( - clippy::missing_panics_doc, - clippy::needless_doctest_main, - clippy::ptr_as_ptr -)] - -extern crate alloc; - -#[cfg(doc)] -extern crate core as std; - -#[macro_use] -mod macros; - -// Not public API. -#[doc(hidden)] -pub mod __private { - #[doc(hidden)] - pub use core::clone::Clone; - #[doc(hidden)] - pub use core::marker::{Send, Sync}; - - #[doc(hidden)] - pub type Box<T> = alloc::boxed::Box<T>; -} - -mod sealed { - pub trait Sealed {} - impl<T: Clone> Sealed for T {} - impl Sealed for str {} - impl<T: Clone> Sealed for [T] {} - pub struct Private; -} - -use crate::sealed::{Private, Sealed}; -use alloc::boxed::Box; -use alloc::rc::Rc; -use alloc::sync::Arc; - -/// This trait is implemented by any type that implements [`std::clone::Clone`]. -pub trait DynClone: Sealed { - // Not public API - #[doc(hidden)] - fn __clone_box(&self, _: Private) -> *mut (); -} - -/// `&T` —▸ `T` -pub fn clone<T>(t: &T) -> T -where - T: DynClone, -{ - unsafe { *Box::from_raw(<T as DynClone>::__clone_box(t, Private) as *mut T) } -} - -/// `&T` —▸ `Box<T>` -pub fn clone_box<T>(t: &T) -> Box<T> -where - T: ?Sized + DynClone, -{ - let mut fat_ptr = t as *const T; - unsafe { - let data_ptr = &mut fat_ptr as *mut *const T as *mut *mut (); - assert_eq!(*data_ptr as *const (), t as *const T as *const ()); - *data_ptr = <T as DynClone>::__clone_box(t, Private); - } - unsafe { Box::from_raw(fat_ptr as *mut T) } -} - -/// `&mut Arc<T>` —▸ `&mut T` -pub fn arc_make_mut<T>(arc: &mut Arc<T>) -> &mut T -where - T: ?Sized + DynClone, -{ - // Atomic. Find out whether the Arc in the argument is the single holder of - // a reference count (strong or weak) on the target object. If yes, it is - // guaranteed to remain that way throughout the rest of this function - // because no other threads could bump the reference count through any other - // Arc (because no others exist) or through this Arc (because the current - // thread holds an exclusive borrow of it). - let is_unique = Arc::get_mut(arc).is_some(); - if !is_unique { - // Non-atomic. - let clone = Arc::from(clone_box(&**arc)); - // Atomic. Check the reference counts again to find out whether the old - // object needs to be dropped. Probably not, but it can happen if all - // the other holders of a reference count went away during the time that - // the clone operation took. - *arc = clone; - } - // Non-atomic. TODO: replace with Arc::get_mut_unchecked when stable. - let ptr = Arc::as_ptr(arc) as *mut T; - unsafe { &mut *ptr } -} - -/// `&mut Rc<T>` —▸ `&mut T` -pub fn rc_make_mut<T>(rc: &mut Rc<T>) -> &mut T -where - T: ?Sized + DynClone, -{ - let is_unique = Rc::get_mut(rc).is_some(); - if !is_unique { - let clone = Rc::from(clone_box(&**rc)); - *rc = clone; - } - let ptr = Rc::as_ptr(rc) as *mut T; - unsafe { &mut *ptr } -} - -impl<T> DynClone for T -where - T: Clone, -{ - fn __clone_box(&self, _: Private) -> *mut () { - Box::<T>::into_raw(Box::new(self.clone())) as *mut () - } -} - -impl DynClone for str { - fn __clone_box(&self, _: Private) -> *mut () { - Box::<str>::into_raw(Box::from(self)) as *mut () - } -} - -impl<T> DynClone for [T] -where - T: Clone, -{ - fn __clone_box(&self, _: Private) -> *mut () { - Box::<[T]>::into_raw(self.iter().cloned().collect()) as *mut () - } -} diff --git a/vendor/dyn-clone/src/macros.rs b/vendor/dyn-clone/src/macros.rs deleted file mode 100644 index b4c09606..00000000 --- a/vendor/dyn-clone/src/macros.rs +++ /dev/null @@ -1,121 +0,0 @@ -use crate::DynClone; - -/// Implement the standard library `Clone` for a trait object that has -/// `DynClone` as a supertrait. -/// -/// ``` -/// use dyn_clone::DynClone; -/// -/// trait MyTrait: DynClone { -/// /* ... */ -/// } -/// -/// dyn_clone::clone_trait_object!(MyTrait); -/// -/// // Now data structures containing Box<dyn MyTrait> can derive Clone. -/// #[derive(Clone)] -/// struct Container { -/// trait_object: Box<dyn MyTrait>, -/// } -/// ``` -/// -/// The macro supports traits that have type parameters and/or `where` clauses. -/// -/// ``` -/// use dyn_clone::DynClone; -/// use std::io::Read; -/// -/// trait Difficult<R>: DynClone where R: Read { -/// /* ... */ -/// } -/// -/// dyn_clone::clone_trait_object!(<R> Difficult<R> where R: Read); -/// ``` -#[macro_export] -macro_rules! clone_trait_object { - ($($path:tt)+) => { - $crate::__internal_clone_trait_object!(begin $($path)+); - }; -} - -#[doc(hidden)] -#[macro_export] -macro_rules! __internal_clone_trait_object { - // Invocation started with `<`, parse generics. - (begin < $($rest:tt)*) => { - $crate::__internal_clone_trait_object!(generics () () $($rest)*); - }; - - // Invocation did not start with `<`. - (begin $first:tt $($rest:tt)*) => { - $crate::__internal_clone_trait_object!(path () ($first) $($rest)*); - }; - - // End of generics. - (generics ($($generics:tt)*) () > $($rest:tt)*) => { - $crate::__internal_clone_trait_object!(path ($($generics)*) () $($rest)*); - }; - - // Generics open bracket. - (generics ($($generics:tt)*) ($($brackets:tt)*) < $($rest:tt)*) => { - $crate::__internal_clone_trait_object!(generics ($($generics)* <) ($($brackets)* <) $($rest)*); - }; - - // Generics close bracket. - (generics ($($generics:tt)*) (< $($brackets:tt)*) > $($rest:tt)*) => { - $crate::__internal_clone_trait_object!(generics ($($generics)* >) ($($brackets)*) $($rest)*); - }; - - // Token inside of generics. - (generics ($($generics:tt)*) ($($brackets:tt)*) $first:tt $($rest:tt)*) => { - $crate::__internal_clone_trait_object!(generics ($($generics)* $first) ($($brackets)*) $($rest)*); - }; - - // End with `where` clause. - (path ($($generics:tt)*) ($($path:tt)*) where $($rest:tt)*) => { - $crate::__internal_clone_trait_object!(impl ($($generics)*) ($($path)*) ($($rest)*)); - }; - - // End without `where` clause. - (path ($($generics:tt)*) ($($path:tt)*)) => { - $crate::__internal_clone_trait_object!(impl ($($generics)*) ($($path)*) ()); - }; - - // Token inside of path. - (path ($($generics:tt)*) ($($path:tt)*) $first:tt $($rest:tt)*) => { - $crate::__internal_clone_trait_object!(path ($($generics)*) ($($path)* $first) $($rest)*); - }; - - // The impl. - (impl ($($generics:tt)*) ($($path:tt)*) ($($bound:tt)*)) => { - #[allow(unknown_lints, non_local_definitions)] // false positive: https://github.com/rust-lang/rust/issues/121621 - impl<'clone, $($generics)*> $crate::__private::Clone for $crate::__private::Box<dyn $($path)* + 'clone> where $($bound)* { - fn clone(&self) -> Self { - $crate::clone_box(&**self) - } - } - - #[allow(unknown_lints, non_local_definitions)] - impl<'clone, $($generics)*> $crate::__private::Clone for $crate::__private::Box<dyn $($path)* + $crate::__private::Send + 'clone> where $($bound)* { - fn clone(&self) -> Self { - $crate::clone_box(&**self) - } - } - - #[allow(unknown_lints, non_local_definitions)] - impl<'clone, $($generics)*> $crate::__private::Clone for $crate::__private::Box<dyn $($path)* + $crate::__private::Sync + 'clone> where $($bound)* { - fn clone(&self) -> Self { - $crate::clone_box(&**self) - } - } - - #[allow(unknown_lints, non_local_definitions)] - impl<'clone, $($generics)*> $crate::__private::Clone for $crate::__private::Box<dyn $($path)* + $crate::__private::Send + $crate::__private::Sync + 'clone> where $($bound)* { - fn clone(&self) -> Self { - $crate::clone_box(&**self) - } - } - }; -} - -clone_trait_object!(DynClone); |