Trait CheapClone

pub trait CheapClone: Clone {
    // Provided method
    fn cheap_clone(&self) -> Self { ... }
}

Things that are fast to clone in the context of an application.

The purpose of this API is to reduce the number of calls to .clone() which need to be audited for performance.

As a rule of thumb, only constant-time Clone impls should also implement CheapClone. Eg:

• ✔ Arc<T>
• ✔ Rc<T>
• ✔ Bytes
• ✗ Vec<T>
• ✔ SmolStr
• ✔ FastStr
• ✗ String

Provided Methods

fn cheap_clone(&self) -> Self

Returns a copy of the value.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl CheapClone for &str

fn cheap_clone(&self) -> &str

impl CheapClone for IpAddr

fn cheap_clone(&self) -> IpAddr

impl CheapClone for SocketAddr

fn cheap_clone(&self) -> SocketAddr

impl CheapClone for bool

fn cheap_clone(&self) -> bool

impl CheapClone for char

fn cheap_clone(&self) -> char

impl CheapClone for f32

fn cheap_clone(&self) -> f32

impl CheapClone for f64

fn cheap_clone(&self) -> f64

impl CheapClone for i8

fn cheap_clone(&self) -> i8

impl CheapClone for i16

fn cheap_clone(&self) -> i16

impl CheapClone for i32

fn cheap_clone(&self) -> i32

impl CheapClone for i64

fn cheap_clone(&self) -> i64

impl CheapClone for i128

fn cheap_clone(&self) -> i128

impl CheapClone for isize

fn cheap_clone(&self) -> isize

impl CheapClone for u8

fn cheap_clone(&self) -> u8

impl CheapClone for u16

fn cheap_clone(&self) -> u16

impl CheapClone for u32

fn cheap_clone(&self) -> u32

impl CheapClone for u64

fn cheap_clone(&self) -> u64

impl CheapClone for u128

fn cheap_clone(&self) -> u128

impl CheapClone for ()

fn cheap_clone(&self)

impl CheapClone for usize

fn cheap_clone(&self) -> usize

impl CheapClone for Ipv4Addr

fn cheap_clone(&self) -> Ipv4Addr

impl CheapClone for Ipv6Addr

fn cheap_clone(&self) -> Ipv6Addr

impl CheapClone for SocketAddrV4

fn cheap_clone(&self) -> SocketAddrV4

impl CheapClone for SocketAddrV6

fn cheap_clone(&self) -> SocketAddrV6

impl CheapClone for NonZero<i8>

fn cheap_clone(&self) -> NonZero<i8>

impl CheapClone for NonZero<i16>

fn cheap_clone(&self) -> NonZero<i16>

impl CheapClone for NonZero<i32>

fn cheap_clone(&self) -> NonZero<i32>

impl CheapClone for NonZero<i64>

fn cheap_clone(&self) -> NonZero<i64>

impl CheapClone for NonZero<i128>

fn cheap_clone(&self) -> NonZero<i128>

impl CheapClone for NonZero<isize>

fn cheap_clone(&self) -> NonZero<isize>

impl CheapClone for NonZero<u8>

fn cheap_clone(&self) -> NonZero<u8>

impl CheapClone for NonZero<u16>

fn cheap_clone(&self) -> NonZero<u16>

impl CheapClone for NonZero<u32>

fn cheap_clone(&self) -> NonZero<u32>

impl CheapClone for NonZero<u64>

fn cheap_clone(&self) -> NonZero<u64>

impl CheapClone for NonZero<u128>

fn cheap_clone(&self) -> NonZero<u128>

impl CheapClone for NonZero<usize>

fn cheap_clone(&self) -> NonZero<usize>

impl<K, V> CheapClone for EntryData<K, V>

where K: CheapClone, V: CheapClone,

fn cheap_clone(&self) -> EntryData<K, V>

impl<K, V> CheapClone for Entry<K, V>

where K: CheapClone, V: CheapClone,

fn cheap_clone(&self) -> Entry<K, V>

impl<T0> CheapClone for (T0,)

where T0: CheapClone,

fn cheap_clone(&self) -> (T0,)

impl<T0, T1> CheapClone for (T0, T1)

where T0: CheapClone, T1: CheapClone,

fn cheap_clone(&self) -> (T0, T1)

impl<T0, T1, T2> CheapClone for (T0, T1, T2)

where T0: CheapClone, T1: CheapClone, T2: CheapClone,

fn cheap_clone(&self) -> (T0, T1, T2)

impl<T0, T1, T2, T3> CheapClone for (T0, T1, T2, T3)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone,

fn cheap_clone(&self) -> (T0, T1, T2, T3)

impl<T0, T1, T2, T3, T4> CheapClone for (T0, T1, T2, T3, T4)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone,

fn cheap_clone(&self) -> (T0, T1, T2, T3, T4)

impl<T0, T1, T2, T3, T4, T5> CheapClone for (T0, T1, T2, T3, T4, T5)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone,

fn cheap_clone(&self) -> (T0, T1, T2, T3, T4, T5)

impl<T0, T1, T2, T3, T4, T5, T6> CheapClone for (T0, T1, T2, T3, T4, T5, T6)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone,

fn cheap_clone(&self) -> (T0, T1, T2, T3, T4, T5, T6)

impl<T0, T1, T2, T3, T4, T5, T6, T7> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone,

fn cheap_clone(&self) -> (T0, T1, T2, T3, T4, T5, T6, T7)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone,

fn cheap_clone(&self) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone, T9: CheapClone,

fn cheap_clone(&self) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone, T9: CheapClone, T10: CheapClone,

fn cheap_clone(&self) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone, T9: CheapClone, T10: CheapClone, T11: CheapClone,

fn cheap_clone(&self) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone, T9: CheapClone, T10: CheapClone, T11: CheapClone, T12: CheapClone,

fn cheap_clone(&self) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone, T9: CheapClone, T10: CheapClone, T11: CheapClone, T12: CheapClone, T13: CheapClone,

fn cheap_clone( &self, ) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone, T9: CheapClone, T10: CheapClone, T11: CheapClone, T12: CheapClone, T13: CheapClone, T14: CheapClone,

fn cheap_clone( &self, ) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone, T9: CheapClone, T10: CheapClone, T11: CheapClone, T12: CheapClone, T13: CheapClone, T14: CheapClone, T15: CheapClone,

fn cheap_clone( &self, ) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone, T9: CheapClone, T10: CheapClone, T11: CheapClone, T12: CheapClone, T13: CheapClone, T14: CheapClone, T15: CheapClone, T16: CheapClone,

fn cheap_clone( &self, ) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone, T9: CheapClone, T10: CheapClone, T11: CheapClone, T12: CheapClone, T13: CheapClone, T14: CheapClone, T15: CheapClone, T16: CheapClone, T17: CheapClone,

fn cheap_clone( &self, ) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone, T9: CheapClone, T10: CheapClone, T11: CheapClone, T12: CheapClone, T13: CheapClone, T14: CheapClone, T15: CheapClone, T16: CheapClone, T17: CheapClone, T18: CheapClone,

fn cheap_clone( &self, ) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone, T9: CheapClone, T10: CheapClone, T11: CheapClone, T12: CheapClone, T13: CheapClone, T14: CheapClone, T15: CheapClone, T16: CheapClone, T17: CheapClone, T18: CheapClone, T19: CheapClone,

fn cheap_clone( &self, ) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone, T9: CheapClone, T10: CheapClone, T11: CheapClone, T12: CheapClone, T13: CheapClone, T14: CheapClone, T15: CheapClone, T16: CheapClone, T17: CheapClone, T18: CheapClone, T19: CheapClone, T20: CheapClone,

fn cheap_clone( &self, ) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone, T9: CheapClone, T10: CheapClone, T11: CheapClone, T12: CheapClone, T13: CheapClone, T14: CheapClone, T15: CheapClone, T16: CheapClone, T17: CheapClone, T18: CheapClone, T19: CheapClone, T20: CheapClone, T21: CheapClone,

fn cheap_clone( &self, ) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone, T9: CheapClone, T10: CheapClone, T11: CheapClone, T12: CheapClone, T13: CheapClone, T14: CheapClone, T15: CheapClone, T16: CheapClone, T17: CheapClone, T18: CheapClone, T19: CheapClone, T20: CheapClone, T21: CheapClone, T22: CheapClone,

fn cheap_clone( &self, ) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22)

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23)

where T0: CheapClone, T1: CheapClone, T2: CheapClone, T3: CheapClone, T4: CheapClone, T5: CheapClone, T6: CheapClone, T7: CheapClone, T8: CheapClone, T9: CheapClone, T10: CheapClone, T11: CheapClone, T12: CheapClone, T13: CheapClone, T14: CheapClone, T15: CheapClone, T16: CheapClone, T17: CheapClone, T18: CheapClone, T19: CheapClone, T20: CheapClone, T21: CheapClone, T22: CheapClone, T23: CheapClone,

fn cheap_clone( &self, ) -> (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, T17, T18, T19, T20, T21, T22, T23)

impl<T> CheapClone for Option<T>

where T: CheapClone,

impl<T> CheapClone for &T

fn cheap_clone(&self) -> &T

impl<T> CheapClone for Box<T>

where T: CheapClone,

impl<T> CheapClone for Rc<T>

where T: ?Sized,

impl<T> CheapClone for Arc<T>

where T: ?Sized,

impl<T> CheapClone for Pin<T>

where T: CheapClone,

impl<T, E> CheapClone for Result<T, E>

where T: CheapClone, E: CheapClone,

impl<T, const N: usize> CheapClone for [T; N]

where T: Copy,

fn cheap_clone(&self) -> [T; N]

impl<V> CheapClone for EntryValue<V>

where V: CheapClone,

fn cheap_clone(&self) -> EntryValue<V>

Implementors