Sha256: 03b1ed61cbed242c286c3c4c5c848dbd57e02ab83fcef264f3a592b58107f324

Contents?: true

Size: 857 Bytes

Versions: 25

Compression:

Stored size: 857 Bytes

Contents

use crate::Itertools;

/// Combine all an iterator's elements into one element by using [`Extend`].
///
/// [`IntoIterator`]-enabled version of [`Itertools::concat`].
///
/// This combinator will extend the first item with each of the rest of the
/// items of the iterator. If the iterator is empty, the default value of
/// `I::Item` is returned.
///
/// ```rust
/// use itertools::concat;
/// 
/// let input = vec![vec![1], vec![2, 3], vec![4, 5, 6]];
/// assert_eq!(concat(input), vec![1, 2, 3, 4, 5, 6]);
/// ```
pub fn concat<I>(iterable: I) -> I::Item
    where I: IntoIterator,
          I::Item: Extend<<<I as IntoIterator>::Item as IntoIterator>::Item> + IntoIterator + Default
{
    #[allow(deprecated)] //TODO: once msrv hits 1.51. replace `fold1` with `reduce`
    iterable.into_iter().fold1(|mut a, b| { a.extend(b); a }).unwrap_or_default()
}

Version data entries

25 entries across 25 versions & 1 rubygems

Version Path
wasmtime-18.0.3 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-17.0.1 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-17.0.0 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-16.0.0 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-15.0.1 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-15.0.0 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-14.0.4 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-14.0.3 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-14.0.1 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-14.0.0 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-13.0.0 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-12.0.1 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-12.0.0 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-11.0.0 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-10.0.1 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-10.0.0 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-9.0.4 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-9.0.1 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-8.0.0 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs
wasmtime-7.0.0 ./ext/cargo-vendor/itertools-0.10.5/src/concat_impl.rs