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

impl Clone for IpAddr
[src]

impl Clone for FileType
[src]

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

Important traits for Iter<'a>

impl Clone for Ipv4Addr
[src]

impl Clone for SeekFrom
[src]

impl Clone for stat
[src]

impl Clone for StripPrefixError
[src]

impl Clone for SocketAddr
[src]

impl Clone for IntoStringError
[src]

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

impl Clone for WaitTimeoutResult
[src]

impl Clone for RecvTimeoutError
[src]

impl Clone for OsString
[src]

impl Clone for CString
[src]

impl Clone for Instant
[src]

impl Clone for TryRecvError
[src]

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

impl Clone for VarError
[src]

impl Clone for SystemTimeError
[src]

impl Clone for Ipv6MulticastScope
[src]

impl Clone for Output
[src]

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

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

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

Important traits for Cursor<T>

impl Clone for Ipv6Addr
[src]

impl Clone for SocketAddrV6
[src]

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

impl Clone for SystemTime
[src]

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

impl Clone for ErrorKind
[src]

impl Clone for Permissions
[src]

impl Clone for Metadata
[src]

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

Important traits for Components<'a>

impl Clone for RecvError
[src]

impl Clone for Thread
[src]

impl Clone for ThreadId
[src]

impl Clone for FromBytesWithNulError
[src]

impl Clone for ExitCode
[src]

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

Important traits for Ancestors<'a>

impl Clone for SocketAddrV4
[src]

impl Clone for ExitStatus
[src]

impl Clone for SocketAddr
[src]

impl Clone for OpenOptions
[src]

impl Clone for Shutdown
[src]

impl Clone for PathBuf
[src]

impl Clone for NulError
[src]

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

impl Clone for ParseIntError
[src]

impl Clone for bool
[src]

impl Clone for i32
[src]

impl Clone for i8x4
[src]

impl Clone for TryFromIntError
[src]

impl Clone for u16x32
[src]

impl Clone for f32x8
[src]

impl Clone for u8x4
[src]

impl Clone for m32x2
[src]

impl Clone for u8x32
[src]

impl Clone for m8x2
[src]

impl Clone for u16
[src]

impl Clone for i64x8
[src]

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

Panics

Panics if the value is currently mutably borrowed.

impl Clone for u8x16
[src]

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

impl Clone for i16
[src]

impl Clone for ToLowercase
[src]

Important traits for ToLowercase

impl Clone for u64
[src]

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

Important traits for DecodeUtf8<I>

impl Clone for i8x16
[src]

impl Clone for NonZeroU16
[src]

impl Clone for m8x4
[src]

impl Clone for NonZeroU128
[src]

impl Clone for m32x8
[src]

impl Clone for u8x64
[src]

impl Clone for i16x8
[src]

impl Clone for u64x4
[src]

impl Clone for TraitObject
[src]

impl Clone for u32x2
[src]

impl Clone for ToUppercase
[src]

Important traits for ToUppercase

impl Clone for i8x8
[src]

impl Clone for u16x16
[src]

impl Clone for i32x16
[src]

impl Clone for EscapeDebug
[src]

Important traits for EscapeDebug

impl Clone for f64x8
[src]

impl Clone for u64x8
[src]

impl Clone for Ordering
[src]

impl Clone for i64
[src]

impl Clone for f32x2
[src]

impl Clone for i16x4
[src]

impl Clone for u16x8
[src]

impl Clone for EscapeDefault
[src]

Important traits for EscapeDefault

impl Clone for TypeId
[src]

impl Clone for ParseFloatError
[src]

impl Clone for m1x32
[src]

impl Clone for Duration
[src]

impl Clone for Pinned
[src]

impl Clone for isize
[src]

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

impl Clone for ParseCharError
[src]

impl Clone for f64x2
[src]

impl Clone for FpCategory
[src]

impl Clone for f32x16
[src]

impl Clone for m32x4
[src]

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

impl Clone for f32
[src]

impl Clone for u8x8
[src]

impl Clone for u8x2
[src]

impl Clone for i16x32
[src]

impl Clone for Layout
[src]

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

Important traits for &'a mut R

impl Clone for i16x16
[src]

impl Clone for NonZeroU64
[src]

impl Clone for u32x8
[src]

impl Clone for f64
[src]

impl Clone for m8x32
[src]

impl Clone for u128
[src]

impl Clone for CharTryFromError
[src]

impl Clone for m1x16
[src]

impl Clone for i128
[src]

impl Clone for NonZeroUsize
[src]

impl Clone for u32x4
[src]

impl Clone for NonZeroU32
[src]

impl Clone for TryFromSliceError
[src]

impl Clone for u64x2
[src]

impl Clone for i32x2
[src]

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

impl Clone for i64x4
[src]

impl Clone for m16x4
[src]

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

impl Clone for u32x16
[src]

impl Clone for i32x4
[src]

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

Important traits for DecodeUtf16<I>

impl Clone for i8x2
[src]

impl Clone for i32x8
[src]

impl Clone for i8x32
[src]

impl Clone for i8
[src]

impl Clone for UnicodeVersion
[src]

impl Clone for NonZeroU8
[src]

impl Clone for f32x4
[src]

impl Clone for m1x64
[src]

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

impl Clone for m64x4
[src]

impl Clone for f64x4
[src]

impl Clone for char
[src]

impl Clone for !
[src]

impl Clone for usize
[src]

impl Clone for AllocErr
[src]

impl Clone for m16x16
[src]

impl Clone for m16x8
[src]

impl Clone for u16x4
[src]

impl Clone for m1x8
[src]

impl Clone for u16x2
[src]

impl Clone for u8
[src]

impl Clone for i16x2
[src]

impl Clone for i64x2
[src]

impl Clone for LayoutErr
[src]

impl Clone for m8x8
[src]

impl Clone for DecodeUtf16Error
[src]

impl Clone for m64x2
[src]

impl Clone for i8x64
[src]

impl Clone for EscapeUnicode
[src]

Important traits for EscapeUnicode

impl Clone for CannotReallocInPlace
[src]

impl Clone for m16x2
[src]

impl Clone for u32
[src]

impl Clone for m8x16
[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<'a, B> Clone for Cow<'a, B> where
    B: ToOwned + ?Sized
[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::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 Global
[src]

impl Clone for iovec
[src]

impl Clone for ff_periodic_effect
[src]

impl Clone for mq_attr
[src]

impl Clone for passwd
[src]

impl Clone for statvfs
[src]

impl Clone for msqid_ds
[src]

impl Clone for dqblk
[src]

impl Clone for __exit_status
[src]

impl Clone for statfs
[src]

impl Clone for sockaddr_in6
[src]

impl Clone for msginfo
[src]

impl Clone for aiocb
[src]

impl Clone for sigevent
[src]

impl Clone for timeval
[src]

impl Clone for epoll_event
[src]

impl Clone for input_id
[src]

impl Clone for _libc_fpxreg
[src]

impl Clone for ucontext_t
[src]

impl Clone for sockaddr_in
[src]

impl Clone for dirent
[src]

impl Clone for rlimit64
[src]

impl Clone for ff_envelope
[src]

impl Clone for mmsghdr
[src]

impl Clone for timespec
[src]

impl Clone for genlmsghdr
[src]

impl Clone for pthread_cond_t
[src]

impl Clone for input_absinfo
[src]

impl Clone for sigval
[src]

impl Clone for input_keymap_entry
[src]

impl Clone for Elf64_Phdr
[src]

impl Clone for ipc_perm
[src]

impl Clone for ff_condition_effect
[src]

impl Clone for glob64_t
[src]

impl Clone for statvfs64
[src]

impl Clone for Dl_info
[src]

impl Clone for sigset_t
[src]

impl Clone for ipv6_mreq
[src]

impl Clone for rlimit
[src]

impl Clone for linger
[src]

impl Clone for __timeval
[src]

impl Clone for flock
[src]

impl Clone for ucred
[src]

impl Clone for ip_mreq
[src]

impl Clone for if_nameindex
[src]

impl Clone for ff_constant_effect
[src]

impl Clone for sysinfo
[src]

impl Clone for stat64
[src]

impl Clone for ff_trigger
[src]

impl Clone for user_fpregs_struct
[src]

impl Clone for nlmsghdr
[src]

impl Clone for sockaddr_storage
[src]

impl Clone for input_mask
[src]

impl Clone for user
[src]

impl Clone for utmpx
[src]

impl Clone for ff_ramp_effect
[src]

impl Clone for fsid_t
[src]

impl Clone for posix_spawnattr_t
[src]

impl Clone for ifaddrs
[src]

impl Clone for hostent
[src]

impl Clone for nl_mmap_req
[src]

impl Clone for pthread_mutex_t
[src]

impl Clone for nlattr
[src]

impl Clone for pollfd
[src]

impl Clone for tms
[src]

impl Clone for signalfd_siginfo
[src]

impl Clone for nlmsgerr
[src]

impl Clone for user_regs_struct
[src]

impl Clone for utsname
[src]

impl Clone for mcontext_t
[src]

impl Clone for sem_t
[src]

impl Clone for pthread_condattr_t
[src]

impl Clone for termios2
[src]

impl Clone for sched_param
[src]

impl Clone for protoent
[src]

impl Clone for shmid_ds
[src]

impl Clone for ff_effect
[src]

impl Clone for ff_rumble_effect
[src]

impl Clone for pthread_rwlockattr_t
[src]

impl Clone for itimerspec
[src]

impl Clone for posix_spawn_file_actions_t
[src]

impl Clone for nl_mmap_hdr
[src]

impl Clone for _libc_xmmreg
[src]

impl Clone for msghdr
[src]

impl Clone for sockaddr
[src]

impl Clone for cpu_set_t
[src]

impl Clone for cmsghdr
[src]

impl Clone for servent
[src]

impl Clone for spwd
[src]

impl Clone for pthread_attr_t
[src]

impl Clone for sockaddr_un
[src]

impl Clone for utimbuf
[src]

impl Clone for dl_phdr_info
[src]

impl Clone for in6_addr
[src]

impl Clone for nl_pktinfo
[src]

impl Clone for in_addr
[src]

impl Clone for rusage
[src]

impl Clone for itimerval
[src]

impl Clone for _libc_fpstate
[src]

impl Clone for siginfo_t
[src]

impl Clone for pthread_mutexattr_t
[src]

impl Clone for input_event
[src]

impl Clone for sembuf
[src]

impl Clone for fd_set
[src]

impl Clone for mallinfo
[src]

impl Clone for stack_t
[src]

impl Clone for sigaction
[src]

impl Clone for group
[src]

impl Clone for statfs64
[src]

impl Clone for termios
[src]

impl Clone for Elf32_Phdr
[src]

impl Clone for winsize
[src]

impl Clone for pthread_rwlock_t
[src]

impl Clone for lconv
[src]

impl Clone for sockaddr_ll
[src]

impl Clone for addrinfo
[src]

impl Clone for ff_replay
[src]

impl Clone for tm
[src]

impl Clone for dirent64
[src]

impl Clone for stat
[src]

impl Clone for mntent
[src]

impl Clone for glob_t
[src]

impl Clone for sockaddr_nl
[src]

impl Clone for _Unwind_Reason_Code

impl Clone for _Unwind_Action

impl Clone for __timeval
[src]

impl Clone for ff_envelope
[src]

impl Clone for stack_t
[src]

impl Clone for addrinfo
[src]

impl Clone for cpu_set_t
[src]

impl Clone for rtentry
[src]

impl Clone for genlmsghdr
[src]

impl Clone for in6_pktinfo
[src]

impl Clone for cmsghdr
[src]

impl Clone for in6_addr
[src]

impl Clone for ff_rumble_effect
[src]

impl Clone for _libc_xmmreg
[src]

impl Clone for sockaddr_in
[src]

impl Clone for sockaddr_nl
[src]

impl Clone for ucontext_t
[src]

impl Clone for _libc_fpxreg
[src]

impl Clone for linger
[src]

impl Clone for input_absinfo
[src]

impl Clone for _libc_fpstate
[src]

impl Clone for nlmsghdr
[src]

impl Clone for sockaddr_in6
[src]

impl Clone for mcontext_t
[src]

impl Clone for rlimit64
[src]

impl Clone for pollfd
[src]

impl Clone for ff_condition_effect
[src]

impl Clone for timespec
[src]

impl Clone for dl_phdr_info
[src]

impl Clone for if_nameindex
[src]

impl Clone for itimerval
[src]

impl Clone for signalfd_siginfo
[src]

impl Clone for aiocb
[src]

impl Clone for epoll_event
[src]

impl Clone for rusage
[src]

impl Clone for flock
[src]

impl Clone for sigval
[src]

impl Clone for posix_spawn_file_actions_t
[src]

impl Clone for timeval
[src]

impl Clone for itimerspec
[src]

impl Clone for nlattr
[src]

impl Clone for in_addr
[src]

impl Clone for tm
[src]

impl Clone for dirent
[src]

impl Clone for sockaddr_un
[src]

impl Clone for user_regs_struct
[src]

impl Clone for pthread_mutexattr_t
[src]

impl Clone for __exit_status
[src]

impl Clone for sigevent
[src]

impl Clone for group
[src]

impl Clone for ipc_perm
[src]

impl Clone for input_mask
[src]

impl Clone for sigset_t
[src]

impl Clone for statvfs64
[src]

impl Clone for ucred
[src]

impl Clone for winsize
[src]

impl Clone for fsid_t
[src]

impl Clone for termios
[src]

impl Clone for ff_trigger
[src]

impl Clone for pthread_rwlock_t
[src]

impl Clone for input_keymap_entry
[src]

impl Clone for user
[src]

impl Clone for arphdr
[src]

impl Clone for lconv
[src]

impl Clone for sem_t
[src]

impl Clone for pthread_rwlockattr_t
[src]

impl Clone for mmsghdr
[src]

impl Clone for ff_periodic_effect
[src]

impl Clone for utimbuf
[src]

impl Clone for tms
[src]

impl Clone for shmid_ds
[src]

impl Clone for sockaddr_ll
[src]

impl Clone for arpreq
[src]

impl Clone for input_id
[src]

impl Clone for statfs64
[src]

impl Clone for iovec
[src]

impl Clone for ifaddrs
[src]

impl Clone for termios2
[src]

impl Clone for Elf32_Phdr
[src]

impl Clone for hostent
[src]

impl Clone for ff_replay
[src]

impl Clone for msginfo
[src]

impl Clone for Elf64_Phdr
[src]

impl Clone for dirent64
[src]

impl Clone for nlmsgerr
[src]

impl Clone for msghdr
[src]

impl Clone for ipv6_mreq
[src]

impl Clone for posix_spawnattr_t
[src]

impl Clone for in6_rtmsg
[src]

impl Clone for siginfo_t
[src]

impl Clone for ff_constant_effect
[src]

impl Clone for stat64
[src]

impl Clone for sockaddr_storage
[src]

impl Clone for nl_mmap_req
[src]

impl Clone for pthread_cond_t
[src]

impl Clone for fd_set
[src]

impl Clone for passwd
[src]

impl Clone for in_pktinfo
[src]

impl Clone for mntent
[src]

impl Clone for statfs
[src]

impl Clone for pthread_mutex_t
[src]

impl Clone for dqblk
[src]

impl Clone for arpd_request
[src]

impl Clone for arpreq_old
[src]

impl Clone for sigaction
[src]

impl Clone for mq_attr
[src]

impl Clone for sembuf
[src]

impl Clone for spwd
[src]

impl Clone for ip_mreq
[src]

impl Clone for Dl_info
[src]

impl Clone for stat
[src]

impl Clone for msqid_ds
[src]

impl Clone for utsname
[src]

impl Clone for pthread_condattr_t
[src]

impl Clone for mallinfo
[src]

impl Clone for packet_mreq
[src]

impl Clone for sockaddr
[src]

impl Clone for protoent
[src]

impl Clone for user_fpregs_struct
[src]

impl Clone for glob_t
[src]

impl Clone for nl_mmap_hdr
[src]

impl Clone for ff_ramp_effect
[src]

impl Clone for input_event
[src]

impl Clone for sched_param
[src]

impl Clone for servent
[src]

impl Clone for utmpx
[src]

impl Clone for nl_pktinfo
[src]

impl Clone for statvfs
[src]

impl Clone for ff_effect
[src]

impl Clone for pthread_attr_t
[src]

impl Clone for sysinfo
[src]

impl Clone for glob64_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