net.emaze.dysfunctional

Class Multiplexing

java.lang.Object

net.emaze.dysfunctional.Multiplexing

public abstract class Multiplexing
extends Object

Constructor Summary

Constructors

Constructor and Description
Multiplexing()

Method Summary

Modifier and Type	Method and Description
static <E,I extends Iterator<E>> Iterator<E>	chain(I... iterators) Flattens passed iterators of E to an iterator of E.
static <E,I extends Iterator<E>> Iterator<E>	chain(Iterable<I> iterators) Flattens an iterable of iterators of E to an iterator of E.
static <E,I extends Iterator<E>> Iterator<E>	chain(Iterator<I> iterators) Flattens an iterator of iterators of E to an iterator of E.
static <E> Iterator<E>	cycle(E... array) Creates an infinite iterator that issues elements from the parameter cyclicly.
static <E> Iterator<E>	cycle(Iterable<E> iterable) Creates an infinite iterator that issues elements from the parameter cyclicly.
static <E> Iterator<E>	cycle(Iterator<E> iterator) Creates an infinite iterator that issues elements from the parameter cyclicly.
static <E,I extends Iterable<E>> Iterator<E>	flatten(I... iterables) Flattens passed iterables of E to an iterator of E.
static <I extends Iterable<E>,E> Iterator<E>	flatten(Iterable<I> iterables) Flattens an iterable of iterables of E to an iterator of E.
static <I extends Iterable<E>,E> Iterator<E>	flatten(Iterator<I> iterables) Flattens an iterator of iterables of E to an iterator of E.
static <E,I extends Iterator<E>> Iterator<E>	roundrobin(Iterable<I> iterators) Multiplexes an iterator of iterators into an iterator.
static <E> Iterator<E>	roundrobin(Iterator<E>... iterators) Multiplexes an iterator of iterators into an iterator.
static <E,I extends Iterator<E>> Iterator<E>	roundrobin(Iterator<I> iterators) Multiplexes an iterator of iterators into an iterator.
static <E,I extends Iterator<E>> Iterator<Optional<E>>	roundrobinLongest(Iterable<I> iterators) Multiplexes an iterable of iterators into a single iterator.
static <E> Iterator<Optional<E>>	roundrobinLongest(Iterator<E>... iterators) Multiplexes two iterators into a single iterator.
static <E,I extends Iterator<E>> Iterator<Optional<E>>	roundrobinLongest(Iterator<I> iterators) Multiplexes an iterator of iterators into a single iterator.
static <E,I extends Iterator<E>> Iterator<E>	roundrobinShortest(Iterable<I> iterators) Multiplexes an iterable of iterators into a single iterator.
static <E> Iterator<E>	roundrobinShortest(Iterator<E>... iterators) Multiplexes two iterators into a single iterator.
static <E,I extends Iterator<E>> Iterator<E>	roundrobinShortest(Iterator<I> iterators) Multiplexes an iterator of iterators into a single iterator.
static <E> Iterator<List<E>>	unchain(int channelSize, E... array) Demultiplexes elements from the source array into an iterator of channels.
static <E> Iterator<List<E>>	unchain(int channelSize, Iterable<E> iterable) Demultiplexes elements from the source iterable into an iterator of channels.
static <C extends Collection<E>,E> Iterator<C>	unchain(int channelSize, Iterable<E> iterable, Supplier<C> channelProvider) Demultiplexes elements from the source iterable into an iterator of channels.
static <E> Iterator<List<E>>	unchain(int channelSize, Iterator<E> iterator) Demultiplexes elements from the source iterator into an iterator of channels.
static <C extends Collection<E>,E> Iterator<C>	unchain(int channelSize, Iterator<E> iterator, Supplier<C> channelProvider) Demultiplexes elements from the source iterator into an iterator of channels.
static <C extends Collection<E>,E> Iterator<C>	unchain(int channelSize, Supplier<C> channelProvider, E... array) Demultiplexes elements from the source array into an iterator of channels.
static <E> Iterator<List<Optional<E>>>	unchainLongest(int channelSize, E... array) Demultiplexes elements from the source array into an iterator of channels.
static <E> Iterator<List<Optional<E>>>	unchainLongest(int channelSize, Iterable<E> iterable) Demultiplexes elements from the source array into an iterator of channels.
static <C extends Collection<Optional<E>>,E> Iterator<C>	unchainLongest(int channelSize, Iterable<E> iterable, Supplier<C> channelProvider) Demultiplexes elements from the source array into an iterator of channels.
static <E> Iterator<List<Optional<E>>>	unchainLongest(int channelSize, Iterator<E> iterator) Demultiplexes elements from the source array into an iterator of channels.
static <C extends Collection<Optional<E>>,E> Iterator<C>	unchainLongest(int channelSize, Iterator<E> iterator, Supplier<C> channelProvider) Demultiplexes elements from the source array into an iterator of channels.
static <C extends Collection<Optional<E>>,E> Iterator<C>	unchainLongest(int channelSize, Supplier<C> channelProvider, E... array) Demultiplexes elements from the source array into an iterator of channels.
static <E> Iterator<List<E>>	unchainShortest(int channelSize, E... array) Demultiplexes elements from the source iterable into an iterator of channels.
static <E> Iterator<List<E>>	unchainShortest(int channelSize, Iterable<E> iterable) Demultiplexes elements from the source iterable into an iterator of channels.
static <C extends Collection<E>,E> Iterator<C>	unchainShortest(int channelSize, Iterable<E> iterable, Supplier<C> channelProvider) Demultiplexes elements from the source iterable into an iterator of channels.
static <E> Iterator<List<E>>	unchainShortest(int channelSize, Iterator<E> iterator) Demultiplexes elements from the source iterable into an iterator of channels.
static <C extends Collection<E>,E> Iterator<C>	unchainShortest(int channelSize, Iterator<E> iterator, Supplier<C> channelProvider) Demultiplexes elements from the source iterable into an iterator of channels.
static <C extends Collection<E>,E> Iterator<C>	unchainShortest(int channelSize, Supplier<C> channelProvider, E... array) Demultiplexes elements from the source iterable into an iterator of channels.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Multiplexing

public Multiplexing()

Method Detail

flatten

public static <I extends Iterable<E>,E> Iterator<E> flatten(Iterator<I> iterables)

Flattens an iterator of iterables of E to an iterator of E. E.g: flatten([1,2], [3,4]) -> [1,2,3,4]

Type Parameters:

I - the iterable type

E - the iterable element type

Parameters:

iterables - the iterator of iterables to be flattened

Returns:

the flattened iterator

flatten

public static <I extends Iterable<E>,E> Iterator<E> flatten(Iterable<I> iterables)

Flattens an iterable of iterables of E to an iterator of E. E.g: flatten([1,2], [3,4]) -> [1,2,3,4]

Type Parameters:

I - the iterable type

E - the iterable element type

Parameters:

iterables - the iterable of iterables to be flattened

Returns:

the flattened iterator

flatten

public static <E,I extends Iterable<E>> Iterator<E> flatten(I... iterables)

Flattens passed iterables of E to an iterator of E. E.g: flatten([1,2], [3,4]) -> [1,2,3,4]

Type Parameters:

E - the iterable element type

I - the iterable type

Parameters:

iterables - the array of iterables to be flattened

Returns:

the flattened iterator

chain

public static <E,I extends Iterator<E>> Iterator<E> chain(Iterator<I> iterators)

Flattens an iterator of iterators of E to an iterator of E. E.g: chain([1,2], [3,4]) -> [1,2,3,4]

Type Parameters:

E - the iterator element type

I - the iterator type

Parameters:

iterators - the source iterators

Returns:

the flattened iterator

chain

public static <E,I extends Iterator<E>> Iterator<E> chain(Iterable<I> iterators)

Flattens an iterable of iterators of E to an iterator of E. E.g: chain([1,2], [3,4]) -> [1,2,3,4]

Type Parameters:

E - the iterator element type

I - the iterator type

Parameters:

iterators - the source iterable

Returns:

the flattened iterator

chain

public static <E,I extends Iterator<E>> Iterator<E> chain(I... iterators)

Flattens passed iterators of E to an iterator of E. E.g: chain([1,2], [3,4]) -> [1,2,3,4]

Type Parameters:

E - the iterator element type

I - the iterator type

Parameters:

iterators - the array of iterators to be flattened

Returns:

the flattened iterator

unchain

public static <C extends Collection<E>,E> Iterator<C> unchain(int channelSize,
                                                              Iterator<E> iterator,
                                                              Supplier<C> channelProvider)

Demultiplexes elements from the source iterator into an iterator of channels. unchain(2, [1,2,3,4,5]) -> [[1,2],[3,4],[5]]

Type Parameters:

C - the channel collection type

E - the element type

Parameters:

channelSize - maximum size of the channel

iterator - the source iterator

channelProvider - a supplier used to create channels

Returns:

an iterator of channels

unchain

public static <E> Iterator<List<E>> unchain(int channelSize,
                                            Iterator<E> iterator)

Demultiplexes elements from the source iterator into an iterator of channels. unchain(2, [1,2,3,4,5]) -> [[1,2],[3,4],[5]]

Type Parameters:

E - the element type

Parameters:

channelSize - maximum size of the channel

iterator - the source iterator

Returns:

an iterator of channels

unchain

public static <C extends Collection<E>,E> Iterator<C> unchain(int channelSize,
                                                              Iterable<E> iterable,
                                                              Supplier<C> channelProvider)

Demultiplexes elements from the source iterable into an iterator of channels. unchain(2, [1,2,3,4,5]) -> [[1,2],[3,4],[5]]

Type Parameters:

C - the channel collection type

E - the element type

Parameters:

channelSize - maximum size of the channel

iterable - the source iterable

channelProvider - the supplier used to create channels

Returns:

an iterator of channels

unchain

public static <E> Iterator<List<E>> unchain(int channelSize,
                                            Iterable<E> iterable)

Demultiplexes elements from the source iterable into an iterator of channels. unchain(2, [1,2,3,4,5]) -> [[1,2],[3,4],[5]]

Type Parameters:

E - the element type

Parameters:

channelSize - maximum size of the channel

iterable - the source iterable

Returns:

an iterator of channels

unchain

public static <C extends Collection<E>,E> Iterator<C> unchain(int channelSize,
                                                              Supplier<C> channelProvider,
                                                              E... array)

Demultiplexes elements from the source array into an iterator of channels. unchain(2, [1,2,3,4,5]) -> [[1,2],[3,4],[5]]

Type Parameters:

C - the channel collection type

E - the element type

Parameters:

channelSize - maximum size of the channel

array - the source array

channelProvider - the supplier used to create channels

Returns:

an iterator of channels

unchain

public static <E> Iterator<List<E>> unchain(int channelSize,
                                            E... array)

Demultiplexes elements from the source array into an iterator of channels. unchain(2, [1,2,3,4,5]) -> [[1,2],[3,4],[5]]

Type Parameters:

E - the element type

Parameters:

channelSize - maximum size of the channel

array - the source array

Returns:

an iterator of channels

roundrobin

public static <E,I extends Iterator<E>> Iterator<E> roundrobin(Iterator<I> iterators)

Multiplexes an iterator of iterators into an iterator. Iteration stops when every element from every source has been consumed. roundRobin([1,2], [3], [4,5]) -> [1,3,4,2,5]

Type Parameters:

E - the element type

I - the iterator type

Parameters:

iterators - the source iterator

Returns:

an iterator yielding multiplexed elements

roundrobin

public static <E,I extends Iterator<E>> Iterator<E> roundrobin(Iterable<I> iterators)

Multiplexes an iterator of iterators into an iterator. Iteration stops when every element from every source has been consumed. roundRobin([1,2], [3], [4,5]) -> [1,3,4,2,5]

Type Parameters:

E - the element type

I - the iterator type

Parameters:

iterators - the source iterable

Returns:

an iterator yielding multiplexed elements

roundrobin

public static <E> Iterator<E> roundrobin(Iterator<E>... iterators)

Multiplexes an iterator of iterators into an iterator. Iteration stops when every element from every source has been consumed. roundRobin([1,2], [3]) -> [1,3,2]

Type Parameters:

E - the element type

Parameters:

iterators - the source iterators

Returns:

an iterator yielding multiplexed elements

roundrobinShortest

public static <E,I extends Iterator<E>> Iterator<E> roundrobinShortest(Iterator<I> iterators)

Multiplexes an iterator of iterators into a single iterator. The iteration stops whenever any of the source iterators is empty causing the same number of elements to be consumed from every iterator. roundrobinShortest([1,2,3], [4,5]) -> [1,4,2,5]

Type Parameters:

E - the element type

I - the iterator type

Parameters:

iterators - the iterator of iterators to be multiplexed

Returns:

an iterator containing multiplexed elements

roundrobinShortest

public static <E,I extends Iterator<E>> Iterator<E> roundrobinShortest(Iterable<I> iterators)

Multiplexes an iterable of iterators into a single iterator. The iteration stops whenever any of the source iterators is empty causing the same number of elements to be consumed from every iterator. E.g: roundrobinShortest([1,2,3], [4,5]) -> [1,4,2,5]

Type Parameters:

E - the element type

I - the source iterator type

Parameters:

iterators - the source iterable

Returns:

an iterator containing multiplexed elements

roundrobinShortest

public static <E> Iterator<E> roundrobinShortest(Iterator<E>... iterators)

Multiplexes two iterators into a single iterator. The iteration stops whenever any of the source iterators is empty causing the same number of elements to be consumed from every iterator. E.g: roundrobinShortest([1,2], [3]) -> [1,3]

Type Parameters:

E - the element type

Parameters:

iterators - the source iterators

Returns:

an iterator containing multiplexed elements

roundrobinLongest

public static <E,I extends Iterator<E>> Iterator<Optional<E>> roundrobinLongest(Iterator<I> iterators)

Multiplexes an iterator of iterators into a single iterator. The iteration stops when every source iterator is empty.E.g: roundrobinLongest([1,2], [4]) -> [of 1, of 4, of 2, empty]

Type Parameters:

E - the element type

I - the iterator type

Parameters:

iterators - the source iterator

Returns:

an iterator containing multiplexed elements

roundrobinLongest

public static <E,I extends Iterator<E>> Iterator<Optional<E>> roundrobinLongest(Iterable<I> iterators)

Multiplexes an iterable of iterators into a single iterator. The iteration stops when every source iterator is empty.E.g: roundrobinLongest([1,2], [4]) -> [of 1, of 4, of 2, empty]

Type Parameters:

E - the element type

I - the iterator type

Parameters:

iterators - the source iterable

Returns:

an iterator containing multiplexed elements

roundrobinLongest

public static <E> Iterator<Optional<E>> roundrobinLongest(Iterator<E>... iterators)

Multiplexes two iterators into a single iterator. The iteration stops when every source iterator is empty.E.g: roundrobinLongest([1,2], [4]) -> [of 1, of 4, of 2, empty]

Type Parameters:

E - the element type

Parameters:

iterators - the source iterators

Returns:

an iterator containing multiplexed elements

cycle

public static <E> Iterator<E> cycle(Iterator<E> iterator)

Creates an infinite iterator that issues elements from the parameter cyclicly.

Type Parameters:

E - the element type

Parameters:

iterator - the iterator to cycle

Returns:

an iterator that cyclicly returns the elements from the argument

cycle

public static <E> Iterator<E> cycle(Iterable<E> iterable)

Creates an infinite iterator that issues elements from the parameter cyclicly.

Type Parameters:

E - the element type

Parameters:

iterable - the iterable to cycle

Returns:

an iterator that cyclicly returns the elements from the argument

cycle

public static <E> Iterator<E> cycle(E... array)

Creates an infinite iterator that issues elements from the parameter cyclicly.

Type Parameters:

E - the element type

Parameters:

array - the array to cycle

Returns:

an iterator that cyclicly returns the elements from the arguments

unchainShortest

public static <C extends Collection<E>,E> Iterator<C> unchainShortest(int channelSize,
                                                                      Iterator<E> iterator,
                                                                      Supplier<C> channelProvider)

Demultiplexes elements from the source iterable into an iterator of channels. All returned channels will have the specified size, any remaining elements will be discarded. unchainShortest(2, [1,2,3,4,5]) -> [[1,2],[3,4]]

Type Parameters:

C - the channel collection type

E - the element type

Parameters:

channelSize - size of the channel

iterator - the source iterator

channelProvider - a supplier used to create channels

Returns:

an iterator of channels

unchainShortest

public static <E> Iterator<List<E>> unchainShortest(int channelSize,
                                                    Iterator<E> iterator)

Demultiplexes elements from the source iterable into an iterator of channels. All returned channels will have the specified size, any remaining elements will be discarded. unchainShortest(2, [1,2,3,4,5]) -> [[1,2],[3,4]]

Type Parameters:

E - the element type

Parameters:

channelSize - size of the channel

iterator - the source iterator

Returns:

an iterator of channels

unchainShortest

public static <C extends Collection<E>,E> Iterator<C> unchainShortest(int channelSize,
                                                                      Iterable<E> iterable,
                                                                      Supplier<C> channelProvider)

Demultiplexes elements from the source iterable into an iterator of channels. All returned channels will have the specified size, any remaining elements will be discarded. unchainShortest(2, [1,2,3,4,5]) -> [[1,2],[3,4]]

Type Parameters:

C - the channel collection type

E - the element type

Parameters:

channelSize - size of the channel

iterable - the source iterable

channelProvider - the supplier used to create channels

Returns:

an iterator of channels

unchainShortest

public static <E> Iterator<List<E>> unchainShortest(int channelSize,
                                                    Iterable<E> iterable)

Demultiplexes elements from the source iterable into an iterator of channels. All returned channels will have the specified size, any remaining elements will be discarded. unchainShortest(2, [1,2,3,4,5]) -> [[1,2],[3,4]]

Type Parameters:

E - the element type

Parameters:

channelSize - size of the channel

iterable - the source iterable

Returns:

an iterator of channels

unchainShortest

public static <C extends Collection<E>,E> Iterator<C> unchainShortest(int channelSize,
                                                                      Supplier<C> channelProvider,
                                                                      E... array)

Demultiplexes elements from the source iterable into an iterator of channels. All returned channels will have the specified size, any remaining elements will be discarded. unchainShortest(2, [1,2,3,4,5]) -> [[1,2],[3,4]]

Type Parameters:

C - the channel collection type

E - the element type

Parameters:

channelSize - size of the channel

array - the source array

channelProvider - the supplier used to create channels

Returns:

an iterator of channels

unchainShortest

public static <E> Iterator<List<E>> unchainShortest(int channelSize,
                                                    E... array)

Demultiplexes elements from the source iterable into an iterator of channels. All returned channels will have the specified size, any remaining elements will be discarded. unchainShortest(2, [1,2,3,4,5]) -> [[1,2],[3,4]]

Type Parameters:

E - the element type

Parameters:

channelSize - size of the channel

array - the source array

Returns:

an iterator of channels

unchainLongest

public static <C extends Collection<Optional<E>>,E> Iterator<C> unchainLongest(int channelSize,
                                                                               Iterator<E> iterator,
                                                                               Supplier<C> channelProvider)

Demultiplexes elements from the source array into an iterator of channels. All returned channels will have the specified size, eventually the last channel could have the last elements empty. unchainLongest(2, [1,2,3,4,5]) -> [[just 1, just 2],[just 3, just 4],[just 5, nothing]]

Type Parameters:

C - the channel collection type

E - the element type

Parameters:

channelSize - size of the channel

iterator - the source iterator

channelProvider - the supplier used to create channels

Returns:

an iterator of channels

unchainLongest

public static <E> Iterator<List<Optional<E>>> unchainLongest(int channelSize,
                                                             Iterator<E> iterator)

Demultiplexes elements from the source array into an iterator of channels. All returned channels will have the specified size, eventually the last channel could have the last elements empty. unchainLongest(2, [1,2,3,4,5]) -> [[just 1, just 2],[just 3, just 4],[just 5, nothing]]

Type Parameters:

E - the element type

Parameters:

channelSize - size of the channel

iterator - the source iterator

Returns:

an iterator of channels

unchainLongest

public static <C extends Collection<Optional<E>>,E> Iterator<C> unchainLongest(int channelSize,
                                                                               Iterable<E> iterable,
                                                                               Supplier<C> channelProvider)

Demultiplexes elements from the source array into an iterator of channels. All returned channels will have the specified size, eventually the last channel could have the last elements empty. unchainLongest(2, [1,2,3,4,5]) -> [[just 1, just 2],[just 3, just 4],[just 5, nothing]]

Type Parameters:

C - the channel collection type

E - the element type

Parameters:

channelSize - size of the channel

iterable - the source iterable

channelProvider - the supplier used to create channels

Returns:

an iterator of channels

unchainLongest

public static <E> Iterator<List<Optional<E>>> unchainLongest(int channelSize,
                                                             Iterable<E> iterable)

Demultiplexes elements from the source array into an iterator of channels. All returned channels will have the specified size, eventually the last channel could have the last elements empty. unchainLongest(2, [1,2,3,4,5]) -> [[just 1, just 2],[just 3, just 4],[just 5, nothing]]

Type Parameters:

E - the element type

Parameters:

channelSize - size of the channel

iterable - the source iterable

Returns:

an iterator of channels

unchainLongest

public static <C extends Collection<Optional<E>>,E> Iterator<C> unchainLongest(int channelSize,
                                                                               Supplier<C> channelProvider,
                                                                               E... array)

Demultiplexes elements from the source array into an iterator of channels. All returned channels will have the specified size, eventually the last channel could have the last elements empty. unchainLongest(2, [1,2,3,4,5]) -> [[just 1, just 2],[just 3, just 4],[just 5, nothing]]

Type Parameters:

C - the channel collection type

E - the element type

Parameters:

channelSize - size of the channel

channelProvider - the supplier used to create channels

array - the source array

Returns:

an iterator of channels

unchainLongest

public static <E> Iterator<List<Optional<E>>> unchainLongest(int channelSize,
                                                             E... array)

Demultiplexes elements from the source array into an iterator of channels. All returned channels will have the specified size, eventually the last channel could have the last elements empty. unchainLongest(2, [1,2,3,4,5]) -> [[just 1, just 2],[just 3, just 4],[just 5, nothing]]

Type Parameters:

E - the element type

Parameters:

channelSize - size of the channel

array - the source array

Returns:

an iterator of channels