starnix_uapi::arch32::__static_assertions::_core::iter

Trait Extend

1.6.0 · Source

pub trait Extend<A> {
    // Required method
    fn extend<T>(&mut self, iter: T)
       where T: IntoIterator<Item = A>;

    // Provided methods
    fn extend_one(&mut self, item: A) { ... }
    fn extend_reserve(&mut self, additional: usize) { ... }
}

Expand description

Extend a collection with the contents of an iterator.

Iterators produce a series of values, and collections can also be thought of as a series of values. The Extend trait bridges this gap, allowing you to extend a collection by including the contents of that iterator. When extending a collection with an already existing key, that entry is updated or, in the case of collections that permit multiple entries with equal keys, that entry is inserted.

§Examples

Basic usage:

// You can extend a String with some chars:
let mut message = String::from("The first three letters are: ");

message.extend(&['a', 'b', 'c']);

assert_eq!("abc", &message[29..32]);

Implementing Extend:

// A sample collection, that's just a wrapper over Vec<T>
#[derive(Debug)]
struct MyCollection(Vec<i32>);

// Let's give it some methods so we can create one and add things
// to it.
impl MyCollection {
    fn new() -> MyCollection {
        MyCollection(Vec::new())
    }

    fn add(&mut self, elem: i32) {
        self.0.push(elem);
    }
}

// since MyCollection has a list of i32s, we implement Extend for i32
impl Extend<i32> for MyCollection {

    // This is a bit simpler with the concrete type signature: we can call
    // extend on anything which can be turned into an Iterator which gives
    // us i32s. Because we need i32s to put into MyCollection.
    fn extend<T: IntoIterator<Item=i32>>(&mut self, iter: T) {

        // The implementation is very straightforward: loop through the
        // iterator, and add() each element to ourselves.
        for elem in iter {
            self.add(elem);
        }
    }
}

let mut c = MyCollection::new();

c.add(5);
c.add(6);
c.add(7);

// let's extend our collection with three more numbers
c.extend(vec![1, 2, 3]);

// we've added these elements onto the end
assert_eq!("MyCollection([5, 6, 7, 1, 2, 3])", format!("{c:?}"));

Required Methods§

1.0.0 · Source

fn extend<T>(&mut self, iter: T)
where T: IntoIterator<Item = A>,

Extends a collection with the contents of an iterator.

As this is the only required method for this trait, the trait-level docs contain more details.

§Examples

// You can extend a String with some chars:
let mut message = String::from("abc");

message.extend(['d', 'e', 'f'].iter());

assert_eq!("abcdef", &message);

Provided Methods§

Source

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

Source

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

The default implementation does nothing.

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Trait Extend Copy item path

§Examples

Required Methods§

fn extend<T>(&mut self, iter: T)where T: IntoIterator<Item = A>,

§Examples

Provided Methods§

fn extend_one(&mut self, item: A)

fn extend_reserve(&mut self, additional: usize)

Dyn Compatibility§

Implementors§

impl Extend<(String, Value)> for Map<String, Value>

impl Extend<AsciiChar> for String

impl Extend<char> for String

impl Extend<()> for ()

impl Extend<PtraceAccessMode> for PtraceAccessMode

impl Extend<SecureBits> for SecureBits

impl Extend<Access> for Access

impl Extend<InotifyMask> for InotifyMask

impl Extend<IptIpFlagsV4> for IptIpFlagsV4

impl Extend<IptIpFlagsV6> for IptIpFlagsV6

impl Extend<IptIpInverseFlags> for IptIpInverseFlags

impl Extend<NfIpHooks> for NfIpHooks

impl Extend<NfNatRangeFlags> for NfNatRangeFlags

impl Extend<XtTcpInverseFlags> for XtTcpInverseFlags

impl Extend<XtUdpInverseFlags> for XtUdpInverseFlags

impl Extend<MountFlags> for MountFlags

impl Extend<OpenFlags> for starnix_uapi::open_flags::OpenFlags

impl Extend<PersonalityFlags> for PersonalityFlags

impl Extend<SealFlags> for SealFlags

impl Extend<UnmountFlags> for UnmountFlags

impl Extend<FdEvents> for FdEvents

impl Extend<ResolveFlags> for ResolveFlags

impl Extend<String> for String

impl Extend<OsString> for OsString

impl Extend<AddressTaggingFeatureFlags> for AddressTaggingFeatureFlags

impl Extend<AllocateMode> for AllocateMode

impl Extend<AtRestFlags> for AtRestFlags

impl Extend<BtiOptions> for BtiOptions

impl Extend<ClockOpts> for ClockOpts

impl Extend<ConfigMutability> for ConfigMutability

impl Extend<ConfigMutability> for ConfigMutability

impl Extend<CpuFeatureFlags> for CpuFeatureFlags

impl Extend<DebugLogOpts> for DebugLogOpts

impl Extend<DynamicFlags> for DynamicFlags

impl Extend<ExceptionChannelOptions> for ExceptionChannelOptions

impl Extend<FileSignal> for FileSignal

impl Extend<Flags> for Flags

impl Extend<IobAccess> for IobAccess

impl Extend<JobCriticalOptions> for JobCriticalOptions

impl Extend<MemoryStallKind> for MemoryStallKind

impl Extend<ModeType> for ModeType

impl Extend<NodeAttributeFlags> for NodeAttributeFlags

impl Extend<NodeAttributesQuery> for NodeAttributesQuery

impl Extend<NodeProtocolKinds> for NodeProtocolKinds

impl Extend<OpenFlags> for OpenFlags

impl Extend<Operations> for Operations

impl Extend<PagerOptions> for PagerOptions

impl Extend<PagerWritebackBeginOptions> for PagerWritebackBeginOptions

impl Extend<PortOptions> for PortOptions

impl Extend<ProcessInfoFlags> for ProcessInfoFlags

impl Extend<ProcessOptions> for ProcessOptions

impl Extend<RaiseExceptionOptions> for RaiseExceptionOptions

impl Extend<ResourceFlag> for ResourceFlag

impl Extend<ResourceKind> for ResourceKind

impl Extend<Rights> for Rights

impl Extend<Signals> for Signals

impl Extend<SocketOpts> for SocketOpts

impl Extend<SocketReadOpts> for SocketReadOpts

impl Extend<SocketWriteOpts> for SocketWriteOpts

impl Extend<StreamOptions> for StreamOptions

impl Extend<StreamReadOptions> for StreamReadOptions

impl Extend<StreamWriteOptions> for StreamWriteOptions

impl Extend<TransferDataOptions> for TransferDataOptions

impl Extend<UnlinkFlags> for UnlinkFlags

impl Extend<VirtualMemoryFeatureFlags> for VirtualMemoryFeatureFlags

impl Extend<VmarFlags> for VmarFlags

impl Extend<VmarFlagsExtended> for VmarFlagsExtended

impl Extend<VmoChildOptions> for VmoChildOptions

impl Extend<VmoFlags> for VmoFlags

impl Extend<VmoInfoFlags> for VmoInfoFlags

Trait Extend

fn extend<T>(&mut self, iter: T)
where T: IntoIterator<Item = A>,

impl<'a, K, V, A> Extend<(&'a K, &'a V)> for BTreeMap<K, V, A>
where K: Ord + Copy, V: Copy, A: Allocator + Clone,

impl<'a, K, V, S> Extend<(&'a K, &'a V)> for std::collections::hash::map::HashMap<K, V, S>
where K: Eq + Hash + Copy, V: Copy, S: BuildHasher,

impl<'a, K, V, S> Extend<(&'a K, &'a V)> for IndexMap<K, V, S>
where K: Hash + Eq + Copy, V: Copy, S: BuildHasher,

impl<'a, K, V, S> Extend<(&'a K, &'a V)> for AHashMap<K, V, S>
where K: Eq + Hash + Copy + 'a, V: Copy + 'a, S: BuildHasher,

impl<'a, K, V, S, A> Extend<&'a (K, V)> for HashMap<K, V, S, A>
where K: Eq + Hash + Copy, V: Copy, S: BuildHasher, A: Allocator + Clone,

impl<'a, K, V, S, A> Extend<(&'a K, &'a V)> for HashMap<K, V, S, A>
where K: Eq + Hash + Copy, V: Copy, S: BuildHasher, A: Allocator + Clone,

impl<'a, T, A> Extend<&'a T> for BinaryHeap<T, A>
where T: 'a + Ord + Copy, A: Allocator,

impl<'a, T, A> Extend<&'a T> for BTreeSet<T, A>
where T: 'a + Ord + Copy, A: Allocator + Clone,

impl<'a, T, A> Extend<&'a T> for LinkedList<T, A>
where T: 'a + Copy, A: Allocator,

impl<'a, T, A> Extend<&'a T> for VecDeque<T, A>
where T: 'a + Copy, A: Allocator,

impl<'a, T, A> Extend<&'a T> for Vec<T, A>
where T: Copy + 'a, A: Allocator,

impl<'a, T, S> Extend<&'a T> for std::collections::hash::set::HashSet<T, S>
where T: 'a + Eq + Hash + Copy, S: BuildHasher,

impl<'a, T, S> Extend<&'a T> for IndexSet<T, S>
where T: Hash + Eq + Copy + 'a, S: BuildHasher,

impl<'a, T, S> Extend<&'a T> for AHashSet<T, S>
where T: 'a + Eq + Hash + Copy, S: BuildHasher,

impl<'a, T, S, A> Extend<&'a T> for HashSet<T, S, A>
where T: 'a + Eq + Hash + Copy, S: BuildHasher, A: Allocator + Clone,

impl<A> Extend<<A as Array>::Item> for ArrayVec<A>
where A: Array,

impl<A> Extend<<A as Array>::Item> for SmallVec<A>
where A: Array,

impl<A> Extend<<A as Array>::Item> for TinyVec<A>
where A: Array,

impl<A> Extend<Box<str, A>> for String
where A: Allocator,

impl<Fut> Extend<Fut> for FuturesOrdered<Fut>
where Fut: Future,

impl<K, V, A> Extend<(K, V)> for BTreeMap<K, V, A>
where K: Ord, A: Allocator + Clone,

impl<K, V, S> Extend<(K, V)> for std::collections::hash::map::HashMap<K, V, S>
where K: Eq + Hash, S: BuildHasher,

impl<K, V, S> Extend<(K, V)> for IndexMap<K, V, S>
where K: Hash + Eq, S: BuildHasher,

impl<K, V, S> Extend<(K, V)> for AHashMap<K, V, S>
where K: Eq + Hash, S: BuildHasher,

impl<K, V, S, A> Extend<(K, V)> for HashMap<K, V, S, A>
where K: Eq + Hash, S: BuildHasher, A: Allocator + Clone,

impl<L, R, A> Extend<A> for Either<L, R>
where L: Extend<A>, R: Extend<A>,

impl<P> Extend<P> for PathBuf
where P: AsRef<Path>,

impl<St> Extend<St> for SelectAll<St>
where St: Stream + Unpin,

impl<T, A> Extend<T> for BinaryHeap<T, A>
where T: Ord, A: Allocator,

impl<T, A> Extend<T> for BTreeSet<T, A>
where T: Ord, A: Allocator + Clone,

impl<T, A> Extend<T> for LinkedList<T, A>
where A: Allocator,

impl<T, A> Extend<T> for VecDeque<T, A>
where A: Allocator,

impl<T, A> Extend<T> for Vec<T, A>
where A: Allocator,

impl<T, ExtendT> Extend<(T₁, T₂, …, Tₙ)> for (ExtendT₁, ExtendT₂, …, ExtendTₙ)
where ExtendT: Extend<T>,

impl<T, S> Extend<T> for std::collections::hash::set::HashSet<T, S>
where T: Eq + Hash, S: BuildHasher,

impl<T, S> Extend<T> for IndexSet<T, S>
where T: Hash + Eq, S: BuildHasher,

impl<T, S> Extend<T> for AHashSet<T, S>
where T: Eq + Hash, S: BuildHasher,

impl<T, S, A> Extend<T> for HashSet<T, S, A>
where T: Eq + Hash, S: BuildHasher, A: Allocator + Clone,