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:

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 WaitTimeoutResult
[src]

impl Clone for FromBytesWithNulError
[src]

impl Clone for Instant
[src]

impl Clone for TryRecvError
[src]

impl Clone for ExitCode
[src]

impl Clone for Thread
[src]

impl Clone for SocketAddr
[src]

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

impl Clone for FileType
[src]

impl Clone for Ipv4Addr
[src]

impl Clone for stat
[src]

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

Important traits for Components<'a>

impl Clone for ThreadId
[src]

impl Clone for SystemTime
[src]

impl Clone for Output
[src]

impl Clone for OpenOptions
[src]

impl Clone for Metadata
[src]

impl Clone for SystemTimeError
[src]

impl Clone for IntoStringError
[src]

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

Important traits for Ancestors<'a>

impl Clone for ExitStatus
[src]

impl Clone for ErrorKind
[src]

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

impl Clone for RecvError
[src]

impl Clone for Shutdown
[src]

impl Clone for SocketAddrV4
[src]

impl Clone for AddrParseError
[src]

impl Clone for OsString
[src]

impl Clone for SeekFrom
[src]

impl Clone for CString
[src]

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

impl Clone for Permissions
[src]

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

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

impl Clone for VarError
[src]

impl Clone for IpAddr
[src]

impl Clone for PathBuf
[src]

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

Important traits for Cursor<T>

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

impl Clone for Ipv6Addr
[src]

impl Clone for StripPrefixError
[src]

impl Clone for NulError
[src]

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

Important traits for Iter<'a>

impl Clone for SocketAddrV6
[src]

impl Clone for RecvTimeoutError
[src]

impl Clone for Ipv6MulticastScope
[src]

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

impl Clone for SocketAddr
[src]

impl Clone for NonZeroU16
[src]

impl Clone for u32
[src]

impl Clone for i8x64
[src]

impl Clone for f64x2
[src]

impl Clone for AllocErr
[src]

impl Clone for f64x4
[src]

impl Clone for LayoutErr
[src]

impl Clone for u8x2
[src]

impl Clone for Ordering
[src]

impl Clone for CannotReallocInPlace
[src]

impl Clone for char
[src]

impl Clone for NonZeroU32
[src]

impl Clone for i16
[src]

impl Clone for CharTryFromError
[src]

impl Clone for f64x8
[src]

impl Clone for ToLowercase
[src]

Important traits for ToLowercase

impl Clone for NonZeroI32
[src]

impl Clone for i16x32
[src]

impl Clone for i64x8
[src]

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

impl Clone for i16x8
[src]

impl Clone for TryFromIntError
[src]

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

Important traits for DecodeUtf8<I>

impl Clone for u16x16
[src]

impl Clone for DecodeUtf16Error
[src]

impl Clone for m16x16
[src]

impl Clone for m8x2
[src]

impl Clone for m16x8
[src]

impl Clone for usize
[src]

impl Clone for u8x32
[src]

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

impl Clone for u8x4
[src]

impl Clone for i64x2
[src]

impl Clone for u16x32
[src]

impl Clone for m16x2
[src]

impl Clone for u128
[src]

impl Clone for m32x8
[src]

impl Clone for m1x8
[src]

impl Clone for m1x64
[src]

impl Clone for u8x16
[src]

impl Clone for i64
[src]

impl Clone for NonZeroIsize
[src]

impl Clone for u8
[src]

impl Clone for i16x16
[src]

impl Clone for i8
[src]

impl Clone for u64
[src]

impl Clone for u64x8
[src]

impl Clone for i32x8
[src]

impl Clone for ParseFloatError
[src]

impl Clone for u32x2
[src]

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

Important traits for DecodeUtf16<I>

impl Clone for EscapeDebug
[src]

Important traits for EscapeDebug

impl Clone for i16x4
[src]

impl Clone for f64
[src]

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

impl Clone for ParseCharError
[src]

impl Clone for u64x4
[src]

impl Clone for i32x16
[src]

impl Clone for f32x8
[src]

impl Clone for m1x16
[src]

impl Clone for m8x32
[src]

impl Clone for NonZeroU64
[src]

impl Clone for m8x4
[src]

impl Clone for UnicodeVersion
[src]

impl Clone for i64x4
[src]

impl Clone for m8x8
[src]

impl Clone for !
[src]

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

impl Clone for ToUppercase
[src]

Important traits for ToUppercase

impl Clone for NonZeroI8
[src]

impl Clone for u64x2
[src]

impl Clone for u16
[src]

impl Clone for Duration
[src]

impl Clone for f32x4
[src]

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

impl Clone for u8x8
[src]

impl Clone for m64x2
[src]

impl Clone for ParseIntError
[src]

impl Clone for u8x64
[src]

impl Clone for i8x16
[src]

impl Clone for m16x4
[src]

impl Clone for u16x4
[src]

impl Clone for f32
[src]

impl Clone for m8x16
[src]

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

Important traits for &'a mut R

impl Clone for TraitObject
[src]

impl Clone for u16x2
[src]

impl Clone for m64x4
[src]

impl Clone for NonZeroI64
[src]

impl Clone for i16x2
[src]

impl Clone for i8x4
[src]

impl Clone for u32x16
[src]

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

Panics

Panics if the value is currently mutably borrowed.

impl Clone for TypeId
[src]

impl Clone for m32x4
[src]

impl Clone for FpCategory
[src]

impl Clone for NonZeroI16
[src]

impl Clone for u32x4
[src]

impl Clone for bool
[src]

impl Clone for NonZeroI128
[src]

impl Clone for u32x8
[src]

impl Clone for i128
[src]

impl Clone for i32x4
[src]

impl Clone for NonZeroUsize
[src]

impl Clone for NonZeroU8
[src]

impl Clone for EscapeDefault
[src]

Important traits for EscapeDefault

impl Clone for i8x32
[src]

impl Clone for isize
[src]

impl Clone for u16x8
[src]

impl Clone for Layout
[src]

impl Clone for m1x32
[src]

impl<T> Clone for NonZero<T> where
    T: Zeroable + Clone
[src]

impl Clone for EscapeUnicode
[src]

Important traits for EscapeUnicode

impl Clone for f32x16
[src]

impl Clone for i32x2
[src]

impl Clone for NonZeroU128
[src]

impl Clone for TryFromSliceError
[src]

impl Clone for i8x2
[src]

impl Clone for i32
[src]

impl Clone for m32x2
[src]

impl Clone for i8x8
[src]

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

impl Clone for f32x2
[src]

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 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::sync::{Arc, Weak};

let weak_five = Arc::downgrade(&Arc::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<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 ipc_perm
[src]

impl Clone for mach_timebase_info
[src]

impl Clone for group
[src]

impl Clone for sockaddr_dl
[src]

impl Clone for if_msghdr
[src]

impl Clone for stat
[src]

impl Clone for sigval
[src]

impl Clone for servent
[src]

impl Clone for termios
[src]

impl Clone for kevent
[src]

impl Clone for in_addr
[src]

impl Clone for ip_mreq
[src]

impl Clone for pollfd
[src]

impl Clone for sockaddr_inarp
[src]

impl Clone for cmsghdr
[src]

impl Clone for sockaddr
[src]

impl Clone for flock
[src]

impl Clone for proc_threadinfo
[src]

impl Clone for hostent
[src]

impl Clone for addrinfo
[src]

impl Clone for msghdr
[src]

impl Clone for sigevent
[src]

impl Clone for itimerval
[src]

impl Clone for sockaddr_storage
[src]

impl Clone for in6_addr
[src]

impl Clone for statvfs
[src]

impl Clone for mach_header
[src]

impl Clone for sockaddr_in6
[src]

impl Clone for rusage
[src]

impl Clone for sockaddr_ctl
[src]

impl Clone for fstore_t
[src]

impl Clone for lconv
[src]

impl Clone for timespec
[src]

impl Clone for dirent
[src]

impl Clone for statfs
[src]

impl Clone for xsw_usage
[src]

impl Clone for fd_set
[src]

impl Clone for radvisory
[src]

impl Clone for sockaddr_un
[src]

impl Clone for proc_taskinfo
[src]

impl Clone for xucred
[src]

impl Clone for pthread_cond_t
[src]

impl Clone for pthread_mutex_t
[src]

impl Clone for sf_hdtr
[src]

impl Clone for passwd
[src]

impl Clone for aiocb
[src]

impl Clone for shmid_ds
[src]

impl Clone for sockaddr_in
[src]

impl Clone for utimbuf
[src]

impl Clone for Dl_info
[src]

impl Clone for kevent64_s
[src]

impl Clone for timeval32
[src]

impl Clone for tms
[src]

impl Clone for pthread_rwlockattr_t
[src]

impl Clone for tm
[src]

impl Clone for utsname
[src]

impl Clone for utmpx
[src]

impl Clone for protoent
[src]

impl Clone for dqblk
[src]

impl Clone for segment_command
[src]

impl Clone for siginfo_t
[src]

impl Clone for winsize
[src]

impl Clone for pthread_attr_t
[src]

impl Clone for pthread_mutexattr_t
[src]

impl Clone for if_nameindex
[src]

impl Clone for ipv6_mreq
[src]

impl Clone for linger
[src]

impl Clone for if_data
[src]

impl Clone for proc_taskallinfo
[src]

impl Clone for timeval
[src]

impl Clone for mach_header_64
[src]

impl Clone for load_command
[src]

impl Clone for fsid_t
[src]

impl Clone for iovec
[src]

impl Clone for bpf_hdr
[src]

impl Clone for sigaction
[src]

impl Clone for rlimit
[src]

impl Clone for proc_bsdinfo
[src]

impl Clone for glob_t
[src]

impl Clone for pthread_rwlock_t
[src]

impl Clone for stack_t
[src]

impl Clone for segment_command_64
[src]

impl Clone for pthread_condattr_t
[src]

impl Clone for ifaddrs
[src]

impl Clone for _Unwind_Action

impl Clone for _Unwind_Reason_Code

impl Clone for fstore_t
[src]

impl Clone for if_nameindex
[src]

impl Clone for pollfd
[src]

impl Clone for mach_header
[src]

impl Clone for utsname
[src]

impl Clone for stat
[src]

impl Clone for servent
[src]

impl Clone for sigevent
[src]

impl Clone for utmpx
[src]

impl Clone for iovec
[src]

impl Clone for if_data
[src]

impl Clone for ipv6_mreq
[src]

impl Clone for proc_taskallinfo
[src]

impl Clone for addrinfo
[src]

impl Clone for segment_command
[src]

impl Clone for sockaddr_in6
[src]

impl Clone for xucred
[src]

impl Clone for pthread_rwlock_t
[src]

impl Clone for msghdr
[src]

impl Clone for winsize
[src]

impl Clone for bpf_hdr
[src]

impl Clone for kevent64_s
[src]

impl Clone for pthread_condattr_t
[src]

impl Clone for ip_mreq
[src]

impl Clone for in6_addr
[src]

impl Clone for segment_command_64
[src]

impl Clone for linger
[src]

impl Clone for fd_set
[src]

impl Clone for kevent
[src]

impl Clone for siginfo_t
[src]

impl Clone for mach_timebase_info
[src]

impl Clone for pthread_mutex_t
[src]

impl Clone for stack_t
[src]

impl Clone for proc_bsdinfo
[src]

impl Clone for rlimit
[src]

impl Clone for radvisory
[src]

impl Clone for flock
[src]

impl Clone for lconv
[src]

impl Clone for sockaddr_dl
[src]

impl Clone for pthread_cond_t
[src]

impl Clone for sockaddr_un
[src]

impl Clone for statfs
[src]

impl Clone for in6_pktinfo
[src]

impl Clone for timeval
[src]

impl Clone for in_addr
[src]

impl Clone for fsid_t
[src]

impl Clone for protoent
[src]

impl Clone for sockaddr_storage
[src]

impl Clone for tm
[src]

impl Clone for termios
[src]

impl Clone for proc_taskinfo
[src]

impl Clone for ipc_perm
[src]

impl Clone for statvfs
[src]

impl Clone for cmsghdr
[src]

impl Clone for sockaddr_ctl
[src]

impl Clone for passwd
[src]

impl Clone for sockaddr_inarp
[src]

impl Clone for pthread_rwlockattr_t
[src]

impl Clone for itimerval
[src]

impl Clone for sigaction
[src]

impl Clone for pthread_attr_t
[src]

impl Clone for sockaddr_in
[src]

impl Clone for mach_header_64
[src]

impl Clone for dirent
[src]

impl Clone for sockaddr
[src]

impl Clone for hostent
[src]

impl Clone for pthread_mutexattr_t
[src]

impl Clone for sf_hdtr
[src]

impl Clone for xsw_usage
[src]

impl Clone for utimbuf
[src]

impl Clone for ifaddrs
[src]

impl Clone for aiocb
[src]

impl Clone for if_msghdr
[src]

impl Clone for shmid_ds
[src]

impl Clone for timeval32
[src]

impl Clone for glob_t
[src]

impl Clone for rusage
[src]

impl Clone for in_pktinfo
[src]

impl Clone for tms
[src]

impl Clone for timespec
[src]

impl Clone for group
[src]

impl Clone for dqblk
[src]

impl Clone for sigval
[src]

impl Clone for proc_threadinfo
[src]

impl Clone for Dl_info
[src]

impl Clone for load_command
[src]

Implementors