Trait nom::lib::std::prelude::v1::v1::Clone1.0.0[][src]

#[lang = "clone"]
pub trait Clone { fn clone(&self) -> Self; fn clone_from(&mut self, source: &Self) { ... } }

A common trait for the ability to explicitly duplicate an object.

Differs from Copy in that Copy is implicit and extremely inexpensive, while Clone is always explicit and may or may not be expensive. In order to enforce these characteristics, Rust does not allow you to reimplement Copy, but you may reimplement Clone and run arbitrary code.

Since Clone is more general than Copy, you can automatically make anything Copy be Clone as well.

Derivable

This trait can be used with #[derive] if all fields are Clone. The derived implementation of clone calls clone on each field.

How can I implement Clone?

Types that are Copy should have a trivial implementation of Clone. More formally: if T: Copy, x: T, and y: &T, then let x = y.clone(); is equivalent to let x = *y;. Manual implementations should be careful to uphold this invariant; however, unsafe code must not rely on it to ensure memory safety.

An example is an array holding more than 32 elements of a type that is Clone; the standard library only implements Clone up until arrays of size 32. In this case, the implementation of Clone cannot be derived, but can be implemented as:

#[derive(Copy)]
struct Stats {
   frequencies: [i32; 100],
}

impl Clone for Stats {
    fn clone(&self) -> Stats { *self }
}

Additional implementors

In addition to the implementors listed below, the following types also implement Clone:

  • Function item types (i.e. the distinct types defined for each function)
  • Function pointer types (e.g. fn() -> i32)
  • Array types, for all sizes, if the item type also implements Clone (e.g. [i32; 123456])
  • Tuple types, if each component also implements Clone (e.g. (), (i32, bool))
  • Closure types, if they capture no value from the environment or if all such captured values implement Clone themselves. Note that variables captured by shared reference always implement Clone (even if the referent doesn't), while variables captured by mutable reference never implement Clone.

Required Methods

Returns a copy of the value.

Examples

let hello = "Hello"; // &str implements Clone

assert_eq!("Hello", hello.clone());

Provided Methods

Performs copy-assignment from source.

a.clone_from(&b) is equivalent to a = b.clone() in functionality, but can be overridden to reuse the resources of a to avoid unnecessary allocations.

Implementations on Foreign Types

impl Clone for PathBuf
[src]

impl<T> Clone for Sender<T>
[src]

impl<'a> Clone for Iter<'a>
[src]

Important traits for Iter<'a>

impl Clone for NulError
[src]

impl Clone for SystemTimeError
[src]

impl Clone for SocketAddrV4
[src]

impl Clone for FileType
[src]

impl Clone for CString
[src]

impl<'a> Clone for Ancestors<'a>
[src]

Important traits for Ancestors<'a>

impl Clone for Ipv4Addr
[src]

impl<'a> Clone for EncodeWide<'a>
[src]

Important traits for EncodeWide<'a>

impl Clone for ThreadId
[src]

impl<T> Clone for TrySendError<T> where
    T: Clone
[src]

impl Clone for ExitStatus
[src]

impl<T> Clone for SendError<T> where
    T: Clone
[src]

impl Clone for Metadata
[src]

impl Clone for Thread
[src]

impl Clone for RecvError
[src]

impl Clone for FromBytesWithNulError
[src]

impl Clone for OsString
[src]

impl<T> Clone for Cursor<T> where
    T: Clone
[src]

Important traits for Cursor<T>

impl Clone for Permissions
[src]

impl<'a> Clone for PrefixComponent<'a>
[src]

impl Clone for Ipv6Addr
[src]

impl<T> Clone for SyncSender<T>
[src]

impl Clone for AddrParseError
[src]

impl Clone for SocketAddrV6
[src]

impl Clone for SeekFrom
[src]

impl Clone for Instant
[src]

impl Clone for ExitCode
[src]

impl Clone for OpenOptions
[src]

impl Clone for StripPrefixError
[src]

impl Clone for Output
[src]

impl Clone for Shutdown
[src]

impl Clone for IpAddr
[src]

impl Clone for VarError
[src]

impl<'a> Clone for Components<'a>
[src]

Important traits for Components<'a>

impl<'a> Clone for Component<'a>
[src]

impl Clone for WaitTimeoutResult
[src]

impl Clone for IntoStringError
[src]

impl Clone for SocketAddr
[src]

impl Clone for SystemTime
[src]

impl<'a> Clone for Prefix<'a>
[src]

impl Clone for Ipv6MulticastScope
[src]

impl Clone for TryRecvError
[src]

impl Clone for RecvTimeoutError
[src]

impl Clone for ErrorKind
[src]

impl Clone for DecodeUtf16Error
[src]

impl Clone for i16
[src]

impl Clone for u128
[src]

impl Clone for m8x8
[src]

impl Clone for m8x16
[src]

impl Clone for TypeId
[src]

impl Clone for NonZeroU64
[src]

impl Clone for i32x2
[src]

impl Clone for u8x16
[src]

impl Clone for i128
[src]

impl Clone for f64
[src]

impl Clone for m1x16
[src]

impl Clone for m1x64
[src]

impl Clone for i64
[src]

impl Clone for EscapeDebug
[src]

Important traits for EscapeDebug

impl Clone for u32x16
[src]

impl Clone for m1x8
[src]

impl<I> Clone for DecodeUtf16<I> where
    I: Clone + Iterator<Item = u16>, 
[src]

Important traits for DecodeUtf16<I>

impl Clone for NonZeroU8
[src]

impl Clone for i64x4
[src]

impl Clone for m16x16
[src]

impl Clone for u8x2
[src]

impl Clone for i16x32
[src]

impl Clone for u32x4
[src]

impl Clone for u64x2
[src]

impl Clone for u8x4
[src]

impl Clone for i16x2
[src]

impl Clone for char
[src]

impl Clone for Pinned
[src]

impl Clone for i8x64
[src]

impl Clone for i8x16
[src]

impl Clone for ToLowercase
[src]

Important traits for ToLowercase

impl Clone for u16
[src]

impl Clone for i16x4
[src]

impl Clone for f32
[src]

impl Clone for f32x4
[src]

impl Clone for i16x16
[src]

impl Clone for ToUppercase
[src]

Important traits for ToUppercase

impl Clone for TraitObject
[src]

impl Clone for i8x8
[src]

impl Clone for NonZeroU32
[src]

impl Clone for m64x4
[src]

impl Clone for m16x4
[src]

impl Clone for i64x8
[src]

impl Clone for u8
[src]

impl Clone for i32
[src]

impl Clone for NonZeroU16
[src]

impl Clone for f32x2
[src]

impl Clone for u8x32
[src]

impl<T> Clone for PhantomData<T> where
    T: ?Sized
[src]

impl Clone for m1x32
[src]

impl Clone for EscapeDefault
[src]

Important traits for EscapeDefault

impl Clone for u16x8
[src]

impl Clone for u16x4
[src]

impl Clone for LayoutErr
[src]

impl<T> Clone for *const T where
    T: ?Sized
[src]

impl Clone for bool
[src]

impl Clone for i8x4
[src]

impl Clone for ParseFloatError
[src]

impl Clone for m8x4
[src]

impl Clone for u32x2
[src]

impl Clone for i8x32
[src]

impl Clone for i32x16
[src]

impl Clone for Layout
[src]

impl Clone for TryFromIntError
[src]

impl<'a, T> Clone for &'a T where
    T: ?Sized
[src]

Important traits for &'a mut R

impl Clone for isize
[src]

impl Clone for i32x4
[src]

impl Clone for !
[src]

impl Clone for ParseIntError
[src]

impl<T> Clone for NonNull<T> where
    T: ?Sized
[src]

impl Clone for u64x8
[src]

impl Clone for u8x8
[src]

impl Clone for FpCategory
[src]

impl Clone for f64x4
[src]

impl<T> Clone for Cell<T> where
    T: Copy
[src]

impl Clone for u16x32
[src]

impl Clone for ParseCharError
[src]

impl Clone for m16x8
[src]

impl Clone for u64
[src]

impl Clone for m8x32
[src]

impl Clone for i16x8
[src]

impl Clone for CannotReallocInPlace
[src]

impl Clone for f64x8
[src]

impl Clone for u32x8
[src]

impl Clone for m8x2
[src]

impl Clone for m16x2
[src]

impl Clone for EscapeUnicode
[src]

Important traits for EscapeUnicode

impl<T> Clone for Wrapping<T> where
    T: Clone
[src]

impl Clone for NonZeroUsize
[src]

impl Clone for i64x2
[src]

impl Clone for TryFromSliceError
[src]

impl Clone for usize
[src]

impl Clone for m64x2
[src]

impl<T> Clone for RefCell<T> where
    T: Clone
[src]

Panics

Panics if the value is currently mutably borrowed.

impl Clone for UnicodeVersion
[src]

impl Clone for m32x2
[src]

impl Clone for u16x16
[src]

impl Clone for f32x8
[src]

impl<T> Clone for *mut T where
    T: ?Sized
[src]

impl Clone for AllocErr
[src]

impl Clone for i8x2
[src]

impl Clone for f64x2
[src]

impl Clone for Ordering
[src]

impl Clone for f32x16
[src]

impl Clone for u64x4
[src]

impl Clone for CharTryFromError
[src]

impl Clone for i32x8
[src]

impl Clone for m32x4
[src]

impl Clone for u8x64
[src]

impl Clone for NonZeroU128
[src]

impl Clone for u32
[src]

impl<I> Clone for DecodeUtf8<I> where
    I: Clone + Iterator<Item = u8>, 
[src]

Important traits for DecodeUtf8<I>

impl Clone for Duration
[src]

impl Clone for m32x8
[src]

impl Clone for u16x2
[src]

impl Clone for i8
[src]

impl<T> Clone for Rc<T> where
    T: ?Sized
[src]

Makes a clone of the Rc pointer.

This creates another pointer to the same inner value, increasing the strong reference count.

Examples

use std::rc::Rc;

let five = Rc::new(5);

Rc::clone(&five);

impl<T> Clone for Weak<T> where
    T: ?Sized
[src]

Makes a clone of the Weak pointer that points to the same value.

Examples

use std::rc::{Rc, Weak};

let weak_five = Rc::downgrade(&Rc::new(5));

Weak::clone(&weak_five);

impl<'a, B> Clone for Cow<'a, B> where
    B: ToOwned + ?Sized
[src]

impl Clone for Global
[src]

impl<T> Clone for Weak<T> where
    T: ?Sized
[src]

Makes a clone of the Weak pointer that points to the same value.

Examples

use std::sync::{Arc, Weak};

let weak_five = Arc::downgrade(&Arc::new(5));

Weak::clone(&weak_five);

impl<T> Clone for Arc<T> where
    T: ?Sized
[src]

Makes a clone of the Arc pointer.

This creates another pointer to the same inner value, increasing the strong reference count.

Examples

use std::sync::Arc;

let five = Arc::new(5);

Arc::clone(&five);

impl Clone for utimbuf
[src]

impl Clone for timespec
[src]

impl Clone for tm
[src]

impl Clone for timeval
[src]

impl Clone for stat
[src]

impl Clone for timeval
[src]

impl Clone for tm
[src]

impl Clone for stat
[src]

impl Clone for timespec
[src]

impl Clone for utimbuf
[src]

impl<'a> Clone for SetMatchesIter<'a>
[src]

Important traits for SetMatchesIter<'a>

impl<'t> Clone for Match<'t>
[src]

impl Clone for Error
[src]

impl<'a> Clone for SetMatchesIter<'a>
[src]

Important traits for SetMatchesIter<'a>

impl<'t> Clone for Match<'t>
[src]

impl Clone for Regex
[src]

impl Clone for CaptureLocations
[src]

impl Clone for Regex
[src]

impl Clone for SetMatches
[src]

impl Clone for RegexSet
[src]

impl Clone for SetMatches
[src]

impl Clone for CaptureLocations
[src]

impl Clone for RegexSet
[src]

impl<P, T> Clone for AcAutomaton<P, T> where
    P: Clone,
    T: Clone

impl Clone for Match

impl Clone for Sparse

impl<P> Clone for FullAcAutomaton<P> where
    P: Clone

impl Clone for Dense

impl Clone for Comment

impl Clone for Translator

impl Clone for GroupKind

impl Clone for ClassBytes

impl Clone for ClassUnicodeKind

impl Clone for LiteralKind

impl Clone for ClassUnicode

impl Clone for Hir

impl Clone for Span

impl Clone for Repetition

impl Clone for Repetition

impl Clone for HexLiteralKind

impl Clone for ClassUnicodeOpKind

impl Clone for Alternation

impl Clone for TranslatorBuilder

impl Clone for Error

impl Clone for ClassAsciiKind

impl Clone for ClassAscii

impl Clone for Ast

impl Clone for ClassSetItem

impl Clone for RepetitionOp

impl Clone for SetFlags

impl Clone for RepetitionRange

impl Clone for Literal

impl Clone for ClassBytesRange

impl Clone for Class

impl Clone for Error

impl Clone for Concat

impl Clone for ClassPerl

impl Clone for ClassSet

impl Clone for ErrorKind

impl Clone for ParserBuilder

impl Clone for WordBoundary

impl Clone for SpecialLiteralKind

impl Clone for GroupKind

impl Clone for Position

impl Clone for Flags

impl Clone for Literal

impl Clone for Parser

impl Clone for ClassSetBinaryOpKind

impl Clone for Group

impl Clone for RepetitionKind

impl Clone for CaptureName

impl Clone for RepetitionRange

impl Clone for ClassUnicodeRange

impl Clone for AssertionKind

impl Clone for Anchor

impl Clone for Assertion

impl Clone for RepetitionKind

impl Clone for WithComments

impl Clone for ParserBuilder

impl Clone for ClassSetUnion

impl Clone for Error

impl Clone for ClassSetRange

impl Clone for ErrorKind

impl Clone for ClassSetBinaryOp

impl Clone for Parser

impl Clone for FlagsItemKind

impl Clone for Flag

impl Clone for Literal

impl Clone for ClassUnicode

impl Clone for ClassPerlKind

impl Clone for HirKind

impl Clone for Class

impl Clone for FlagsItem

impl Clone for Literals

impl Clone for Group

impl Clone for ClassBracketed

impl Clone for Utf8Sequence

impl Clone for Utf8Range

Implementors