org.cactoos.list

Class Shuffled<T>

java.lang.Object

org.cactoos.collection.CollectionEnvelope<T>

org.cactoos.list.Shuffled<T>

Type Parameters:

T - Element type

All Implemented Interfaces:

Iterable<T>, Collection<T>, List<T>

public final class Shuffled<T>
extends CollectionEnvelope<T>

Shuffled list.

Pay attention that shuffling will happen on each operation with the collection. Every time you touch it, it will fetch the entire list from the encapsulated object and sort it. If you want to avoid that "side-effect", decorate it with StickyList.

There is no thread-safety guarantee.

Since:

0.23

See Also:

StickyList

Constructor Summary

Constructors

Constructor and Description
Shuffled(Collection<T> src) Ctor.
Shuffled(Iterable<T> src) Ctor.
Shuffled(Iterator<T> src) Ctor.
Shuffled(T... src) Ctor.

Method Summary

Modifier and Type	Method and Description
void	add(int index, T element)
boolean	addAll(int index, Collection<? extends T> items)
boolean	equals(Object obj)
T	get(int index)
int	hashCode()
int	indexOf(Object item)
int	lastIndexOf(Object item)
ListIterator<T>	listIterator()
ListIterator<T>	listIterator(int index)
T	remove(int index)
T	set(int index, T element)
List<T>	subList(int start, int end)
String	toString()

Methods inherited from class org.cactoos.collection.CollectionEnvelope

add, addAll, clear, contains, containsAll, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List

add, addAll, clear, contains, containsAll, isEmpty, iterator, remove, removeAll, replaceAll, retainAll, size, sort, spliterator, toArray, toArray

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Constructor Detail

Shuffled

@SafeVarargs
public Shuffled(T... src)

Ctor.

Parameters:

src - The underlying collection

Shuffled

public Shuffled(Iterator<T> src)

Ctor.

Parameters:

src - The underlying collection

Shuffled

public Shuffled(Iterable<T> src)

Ctor.

Parameters:

src - The underlying collection

Shuffled

public Shuffled(Collection<T> src)

Ctor.

Parameters:

src - Source

Method Detail

addAll

public final boolean addAll(int index,
                            Collection<? extends T> items)

Specified by:

addAll in interface List<T>

get

public final T get(int index)

Specified by:

get in interface List<T>

set

public final T set(int index,
                   T element)

Specified by:

set in interface List<T>

add

public final void add(int index,
                      T element)

Specified by:

add in interface List<T>

remove

public final T remove(int index)

Specified by:

remove in interface List<T>

indexOf

public final int indexOf(Object item)

Specified by:

indexOf in interface List<T>

lastIndexOf

public final int lastIndexOf(Object item)

Specified by:

lastIndexOf in interface List<T>

listIterator

public final ListIterator<T> listIterator()

Specified by:

listIterator in interface List<T>

listIterator

public final ListIterator<T> listIterator(int index)

Specified by:

listIterator in interface List<T>

subList

public final List<T> subList(int start,
                             int end)

Specified by:

subList in interface List<T>

equals

public boolean equals(Object obj)

Specified by:

equals in interface Collection<T>

Specified by:

equals in interface List<T>

Overrides:

equals in class Object

hashCode

public int hashCode()

Specified by:

hashCode in interface Collection<T>

Specified by:

hashCode in interface List<T>

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class CollectionEnvelope<T>