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.

Object Safety

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

impl CheapClone for FastStr

impl CheapClone for SmolStr

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<'a, T> CheapClone for &'a T

fn cheap_clone(&self) -> Self

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

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

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: Copy, const N: usize> CheapClone for [T; N]

fn cheap_clone(&self) -> Self

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

impl<T: CheapClone> CheapClone for Box<T>

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

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

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

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

Implementors