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) -> Self

impl CheapClone for IpAddr

fn cheap_clone(&self) -> Self

impl CheapClone for SocketAddr

fn cheap_clone(&self) -> Self

impl CheapClone for bool

fn cheap_clone(&self) -> Self

impl CheapClone for char

fn cheap_clone(&self) -> Self

impl CheapClone for f32

fn cheap_clone(&self) -> Self

impl CheapClone for f64

fn cheap_clone(&self) -> Self

impl CheapClone for i8

fn cheap_clone(&self) -> Self

impl CheapClone for i16

fn cheap_clone(&self) -> Self

impl CheapClone for i32

fn cheap_clone(&self) -> Self

impl CheapClone for i64

fn cheap_clone(&self) -> Self

impl CheapClone for i128

fn cheap_clone(&self) -> Self

impl CheapClone for isize

fn cheap_clone(&self) -> Self

impl CheapClone for u8

fn cheap_clone(&self) -> Self

impl CheapClone for u16

fn cheap_clone(&self) -> Self

impl CheapClone for u32

fn cheap_clone(&self) -> Self

impl CheapClone for u64

fn cheap_clone(&self) -> Self

impl CheapClone for u128

fn cheap_clone(&self) -> Self

impl CheapClone for ()

fn cheap_clone(&self) -> Self

impl CheapClone for usize

fn cheap_clone(&self) -> Self

impl CheapClone for Ipv4Addr

fn cheap_clone(&self) -> Self

impl CheapClone for Ipv6Addr

fn cheap_clone(&self) -> Self

impl CheapClone for SocketAddrV4

fn cheap_clone(&self) -> Self

impl CheapClone for SocketAddrV6

fn cheap_clone(&self) -> Self

impl CheapClone for Bytes

Available on crate feature bytes1 only.

impl CheapClone for FastStr

Available on crate feature faststr02 only.

impl CheapClone for SmolStr

Available on crate feature smol_str03 only.

impl CheapClone for SmolStr

Available on crate feature smol_str02 only.

impl CheapClone for NonZeroI8

fn cheap_clone(&self) -> Self

impl CheapClone for NonZeroI16

fn cheap_clone(&self) -> Self

impl CheapClone for NonZeroI32

fn cheap_clone(&self) -> Self

impl CheapClone for NonZeroI64

fn cheap_clone(&self) -> Self

impl CheapClone for NonZeroI128

fn cheap_clone(&self) -> Self

impl CheapClone for NonZeroIsize

fn cheap_clone(&self) -> Self

impl CheapClone for NonZeroU8

fn cheap_clone(&self) -> Self

impl CheapClone for NonZeroU16

fn cheap_clone(&self) -> Self

impl CheapClone for NonZeroU32

fn cheap_clone(&self) -> Self

impl CheapClone for NonZeroU64

fn cheap_clone(&self) -> Self

impl CheapClone for NonZeroU128

fn cheap_clone(&self) -> Self

impl CheapClone for NonZeroUsize

fn cheap_clone(&self) -> Self

impl<L: CheapClone, M: CheapClone, R: CheapClone> CheapClone for Among<L, M, R>

fn cheap_clone(&self) -> Self

impl<L: CheapClone, R: CheapClone> CheapClone for Either<L, R>

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

impl<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> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12)

fn cheap_clone(&self) -> Self

impl<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> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13)

fn cheap_clone(&self) -> Self

impl<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> CheapClone for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14)

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

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

fn cheap_clone(&self) -> Self

impl<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> 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)

fn cheap_clone(&self) -> Self

impl<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> 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)

fn cheap_clone(&self) -> Self

impl<T> CheapClone for &T

fn cheap_clone(&self) -> Self

impl<T> CheapClone for Arc<T>

Available on crate feature triomphe01 only.

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

fn cheap_clone(&self) -> Self

impl<T: CheapClone> CheapClone for Option<T>

fn cheap_clone(&self) -> Self

impl<T: CheapClone> CheapClone for Reverse<T>

fn cheap_clone(&self) -> Self

impl<T: CheapClone> CheapClone for Pin<T>

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

fn cheap_clone(&self) -> Self

impl<T: ?Sized> CheapClone for Rc<T>

impl<T: ?Sized> CheapClone for Arc<T>

Implementors