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<'a> Clone for Prefix<'a>
[src]

impl Clone for RecvTimeoutError
[src]

impl Clone for FileType
[src]

impl Clone for Output
[src]

impl Clone for Ipv6Addr
[src]

impl Clone for PathBuf
[src]

impl Clone for Instant
[src]

impl Clone for VarError
[src]

impl Clone for FromBytesWithNulError
[src]

impl Clone for SocketAddr
[src]

impl Clone for NulError
[src]

impl Clone for OpenOptions
[src]

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

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

Important traits for Ancestors<'a>

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

impl Clone for SeekFrom
[src]

impl Clone for StripPrefixError
[src]

impl Clone for IntoStringError
[src]

impl Clone for IpAddr
[src]

impl Clone for Thread
[src]

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

impl Clone for Ipv4Addr
[src]

impl Clone for ErrorKind
[src]

impl Clone for Shutdown
[src]

impl Clone for Metadata
[src]

impl Clone for AddrParseError
[src]

impl Clone for SocketAddrV4
[src]

impl Clone for stat
[src]

impl Clone for SocketAddr
[src]

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

impl Clone for SystemTimeError
[src]

impl Clone for SocketAddrV6
[src]

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

impl Clone for ExitCode
[src]

impl Clone for TryRecvError
[src]

impl Clone for WaitTimeoutResult
[src]

impl Clone for CString
[src]

impl Clone for RecvError
[src]

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

impl Clone for Permissions
[src]

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

Important traits for Cursor<T>

impl Clone for ThreadId
[src]

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

Important traits for Iter<'a>

impl Clone for Ipv6MulticastScope
[src]

impl Clone for ExitStatus
[src]

impl Clone for OsString
[src]

impl Clone for SystemTime
[src]

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

Important traits for Components<'a>

impl Clone for Pinned
[src]

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

impl Clone for m16x4
[src]

impl Clone for NonZeroU16
[src]

impl Clone for f32x4
[src]

impl Clone for f64x8
[src]

impl Clone for m32x2
[src]

impl Clone for m64x4
[src]

impl Clone for u8x4
[src]

impl Clone for u16x16
[src]

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

impl Clone for u8x64
[src]

impl Clone for i32x2
[src]

impl Clone for m8x32
[src]

impl Clone for ToLowercase
[src]

Important traits for ToLowercase

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

Important traits for DecodeUtf8<I>

impl Clone for m1x8
[src]

impl Clone for u16x8
[src]

impl Clone for NonZeroU128
[src]

impl Clone for i8x32
[src]

impl Clone for u32
[src]

impl Clone for i32
[src]

impl Clone for EscapeUnicode
[src]

Important traits for EscapeUnicode

impl Clone for u16x32
[src]

impl Clone for char
[src]

impl Clone for m16x8
[src]

impl Clone for i16x8
[src]

impl Clone for m32x8
[src]

impl Clone for CharTryFromError
[src]

impl Clone for m32x4
[src]

impl Clone for Ordering
[src]

impl Clone for ParseFloatError
[src]

impl Clone for u32x4
[src]

impl Clone for Layout
[src]

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

impl Clone for UnicodeVersion
[src]

impl Clone for u64
[src]

impl Clone for m16x16
[src]

impl Clone for NonZeroU64
[src]

impl Clone for u64x4
[src]

impl Clone for m64x2
[src]

impl Clone for m1x16
[src]

impl Clone for u16x2
[src]

impl Clone for m8x8
[src]

impl Clone for m8x2
[src]

impl Clone for f32x16
[src]

impl Clone for u8x8
[src]

impl Clone for u32x16
[src]

impl Clone for i16x2
[src]

impl Clone for TryFromIntError
[src]

impl Clone for m1x32
[src]

impl Clone for i16x32
[src]

impl Clone for u8x16
[src]

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

Important traits for DecodeUtf16<I>

impl Clone for usize
[src]

impl Clone for f32x2
[src]

impl Clone for i8
[src]

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

impl Clone for NonZeroU8
[src]

impl Clone for u8x2
[src]

impl Clone for i8x16
[src]

impl Clone for TryFromSliceError
[src]

impl Clone for i8x8
[src]

impl Clone for ParseCharError
[src]

impl Clone for EscapeDebug
[src]

Important traits for EscapeDebug

impl Clone for i16x4
[src]

impl Clone for m8x4
[src]

impl Clone for NonZeroUsize
[src]

impl Clone for i8x4
[src]

impl Clone for FpCategory
[src]

impl Clone for CannotReallocInPlace
[src]

impl Clone for i32x16
[src]

impl Clone for ParseIntError
[src]

impl Clone for u8
[src]

impl Clone for m1x64
[src]

impl Clone for i8x64
[src]

impl Clone for i128
[src]

impl Clone for i32x8
[src]

impl Clone for u16
[src]

impl Clone for LayoutErr
[src]

impl Clone for EscapeDefault
[src]

Important traits for EscapeDefault

impl Clone for DecodeUtf16Error
[src]

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

impl Clone for f64
[src]

impl Clone for i64x2
[src]

impl Clone for Duration
[src]

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

Panics

Panics if the value is currently mutably borrowed.

impl Clone for f32
[src]

impl Clone for f32x8
[src]

impl Clone for AllocErr
[src]

impl Clone for f64x2
[src]

impl Clone for u8x32
[src]

impl Clone for i8x2
[src]

impl Clone for ToUppercase
[src]

Important traits for ToUppercase

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

Important traits for &'a mut R

impl Clone for u64x2
[src]

impl Clone for TraitObject
[src]

impl Clone for m8x16
[src]

impl Clone for i64x4
[src]

impl Clone for i64x8
[src]

impl Clone for u32x8
[src]

impl Clone for u64x8
[src]

impl Clone for NonZeroU32
[src]

impl Clone for u128
[src]

impl Clone for u16x4
[src]

impl Clone for f64x4
[src]

impl Clone for i16
[src]

impl Clone for isize
[src]

impl Clone for bool
[src]

impl Clone for !
[src]

impl Clone for i16x16
[src]

impl Clone for m16x2
[src]

impl Clone for u32x2
[src]

impl Clone for TypeId
[src]

impl Clone for i64
[src]

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

impl Clone for i32x4
[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 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<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 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 Clone for Global
[src]

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

impl Clone for lconv
[src]

impl Clone for mach_header
[src]

impl Clone for xsw_usage
[src]

impl Clone for statfs
[src]

impl Clone for sockaddr_ctl
[src]

impl Clone for utimbuf
[src]

impl Clone for proc_taskinfo
[src]

impl Clone for pthread_mutexattr_t
[src]

impl Clone for itimerval
[src]

impl Clone for msghdr
[src]

impl Clone for mach_header_64
[src]

impl Clone for timeval
[src]

impl Clone for radvisory
[src]

impl Clone for ipc_perm
[src]

impl Clone for ipv6_mreq
[src]

impl Clone for ifaddrs
[src]

impl Clone for passwd
[src]

impl Clone for sigevent
[src]

impl Clone for pthread_attr_t
[src]

impl Clone for pollfd
[src]

impl Clone for if_nameindex
[src]

impl Clone for proc_taskallinfo
[src]

impl Clone for sockaddr_storage
[src]

impl Clone for fsid_t
[src]

impl Clone for Dl_info
[src]

impl Clone for sigaction
[src]

impl Clone for termios
[src]

impl Clone for group
[src]

impl Clone for xucred
[src]

impl Clone for dirent
[src]

impl Clone for sockaddr_in
[src]

impl Clone for in_addr
[src]

impl Clone for if_msghdr
[src]

impl Clone for tms
[src]

impl Clone for aiocb
[src]

impl Clone for servent
[src]

impl Clone for cmsghdr
[src]

impl Clone for ip_mreq
[src]

impl Clone for pthread_rwlockattr_t
[src]

impl Clone for kevent64_s
[src]

impl Clone for flock
[src]

impl Clone for addrinfo
[src]

impl Clone for shmid_ds
[src]

impl Clone for proc_bsdinfo
[src]

impl Clone for sf_hdtr
[src]

impl Clone for pthread_cond_t
[src]

impl Clone for protoent
[src]

impl Clone for statvfs
[src]

impl Clone for pthread_mutex_t
[src]

impl Clone for pthread_condattr_t
[src]

impl Clone for timespec
[src]

impl Clone for fstore_t
[src]

impl Clone for sockaddr_un
[src]

impl Clone for dqblk
[src]

impl Clone for proc_threadinfo
[src]

impl Clone for fd_set
[src]

impl Clone for if_data
[src]

impl Clone for rusage
[src]

impl Clone for stack_t
[src]

impl Clone for sockaddr_dl
[src]

impl Clone for glob_t
[src]

impl Clone for sockaddr
[src]

impl Clone for iovec
[src]

impl Clone for siginfo_t
[src]

impl Clone for sockaddr_inarp
[src]

impl Clone for in6_addr
[src]

impl Clone for sockaddr_in6
[src]

impl Clone for utsname
[src]

impl Clone for kevent
[src]

impl Clone for bpf_hdr
[src]

impl Clone for winsize
[src]

impl Clone for tm
[src]

impl Clone for rlimit
[src]

impl Clone for linger
[src]

impl Clone for utmpx
[src]

impl Clone for mach_timebase_info
[src]

impl Clone for segment_command_64
[src]

impl Clone for segment_command
[src]

impl Clone for hostent
[src]

impl Clone for stat
[src]

impl Clone for pthread_rwlock_t
[src]

impl Clone for sigval
[src]

impl Clone for load_command
[src]

impl Clone for _Unwind_Reason_Code

impl Clone for _Unwind_Action

impl Clone for stack_t
[src]

impl Clone for sockaddr
[src]

impl Clone for stat
[src]

impl Clone for sockaddr_inarp
[src]

impl Clone for dqblk
[src]

impl Clone for sockaddr_ctl
[src]

impl Clone for in6_addr
[src]

impl Clone for statvfs
[src]

impl Clone for pthread_rwlockattr_t
[src]

impl Clone for linger
[src]

impl Clone for radvisory
[src]

impl Clone for if_data
[src]

impl Clone for sockaddr_in6
[src]

impl Clone for proc_taskinfo
[src]

impl Clone for pollfd
[src]

impl Clone for timespec
[src]

impl Clone for itimerval
[src]

impl Clone for shmid_ds
[src]

impl Clone for ipc_perm
[src]

impl Clone for pthread_mutex_t
[src]

impl Clone for rusage
[src]

impl Clone for proc_threadinfo
[src]

impl Clone for sigval
[src]

impl Clone for timeval
[src]

impl Clone for in_addr
[src]

impl Clone for utmpx
[src]

impl Clone for xsw_usage
[src]

impl Clone for bpf_hdr
[src]

impl Clone for fsid_t
[src]

impl Clone for group
[src]

impl Clone for msghdr
[src]

impl Clone for sockaddr_dl
[src]

impl Clone for load_command
[src]

impl Clone for winsize
[src]

impl Clone for tm
[src]

impl Clone for in6_pktinfo
[src]

impl Clone for pthread_cond_t
[src]

impl Clone for if_msghdr
[src]

impl Clone for utimbuf
[src]

impl Clone for tms
[src]

impl Clone for sf_hdtr
[src]

impl Clone for ifaddrs
[src]

impl Clone for iovec
[src]

impl Clone for mach_header
[src]

impl Clone for hostent
[src]

impl Clone for cmsghdr
[src]

impl Clone for in_pktinfo
[src]

impl Clone for mach_timebase_info
[src]

impl Clone for lconv
[src]

impl Clone for addrinfo
[src]

impl Clone for pthread_rwlock_t
[src]

impl Clone for passwd
[src]

impl Clone for ipv6_mreq
[src]

impl Clone for utsname
[src]

impl Clone for dirent
[src]

impl Clone for pthread_mutexattr_t
[src]

impl Clone for fd_set
[src]

impl Clone for sigevent
[src]

impl Clone for aiocb
[src]

impl Clone for xucred
[src]

impl Clone for pthread_attr_t
[src]

impl Clone for proc_taskallinfo
[src]

impl Clone for termios
[src]

impl Clone for mach_header_64
[src]

impl Clone for fstore_t
[src]

impl Clone for glob_t
[src]

impl Clone for proc_bsdinfo
[src]

impl Clone for ip_mreq
[src]

impl Clone for sockaddr_storage
[src]

impl Clone for protoent
[src]

impl Clone for segment_command
[src]

impl Clone for pthread_condattr_t
[src]

impl Clone for statfs
[src]

impl Clone for sockaddr_in
[src]

impl Clone for servent
[src]

impl Clone for sigaction
[src]

impl Clone for kevent64_s
[src]

impl Clone for flock
[src]

impl Clone for sockaddr_un
[src]

impl Clone for arphdr
[src]

impl Clone for segment_command_64
[src]

impl Clone for kevent
[src]

impl Clone for Dl_info
[src]

impl Clone for if_nameindex
[src]

impl Clone for siginfo_t
[src]

impl Clone for rlimit
[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