java8.util

Class Lists

java.lang.Object

java8.util.Lists

public final class Lists
extends Object

A place for static default implementations of the new Java 8 default interface methods and static interface methods in the List interface.

Method Summary

Modifier and Type	Method and Description
static <E> void	replaceAll(List<E> list, UnaryOperator<E> operator) Replaces each element of the passed list with the result of applying the operator to that element.
static <E> void	sort(List<E> list, Comparator<? super E> c) Sorts the passed list using the supplied Comparator to compare elements.
static <E> Spliterator<E>	spliterator(List<E> list) Creates a Spliterator over the elements in the passed list.

Methods inherited from class java.lang.Object

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

Method Detail

sort

public static <E> void sort(List<E> list,
                            Comparator<? super E> c)

Sorts the passed list using the supplied Comparator to compare elements.

Implementation Requirements:
The default implementation is equivalent to, for the passed list:

Collections.sort(list, c)

Type Parameters:

E - the type of the elements of the list to be sorted

Parameters:

list - the list that should be sorted

c - the Comparator used to compare list elements. A null value indicates that the elements' natural ordering should be used

Throws:

ClassCastException - if the list contains elements that are not mutually comparable using the specified comparator

UnsupportedOperationException - if the list's list-iterator does not support the set operation

IllegalArgumentException - (optional) if the comparator is found to violate the Comparator contract

NullPointerException - if the specified list is null

Since:

1.8

replaceAll

public static <E> void replaceAll(List<E> list,
                                  UnaryOperator<E> operator)

Replaces each element of the passed list with the result of applying the operator to that element. Errors or runtime exceptions thrown by the operator are relayed to the caller.

Implementation Requirements:
The default implementation is equivalent to, for the passed list:

     final ListIterator<E> li = list.listIterator();
     while (li.hasNext()) {
         li.set(operator.apply(li.next()));
     }
 

If the list's list-iterator does not support the set operation then an UnsupportedOperationException will be thrown when replacing the first element.

Type Parameters:

E - the type of the elements of the list to be replaced

Parameters:

list - the list whose elements should be replaced

operator - the operator to apply to each element

Throws:

UnsupportedOperationException - if the passed list is unmodifiable. Implementations may throw this exception if an element cannot be replaced or if, in general, modification is not supported

NullPointerException - if the specified list is null or the specified operator is null or if the operator result is a null value and the passed list does not permit null elements (optional)

Since:

1.8

spliterator

public static <E> Spliterator<E> spliterator(List<E> list)

Creates a Spliterator over the elements in the passed list.

The Spliterator reports at least Spliterator.SIZED, Spliterator.ORDERED and Spliterator.SUBSIZED.

Implementation notes: This implementation delegates to Spliterators.spliterator(java.util.Collection) so it is effectively the same as calling

     Spliterators.spliterator(list);
 

Type Parameters:

E - the type of the elements of the list to be splitted

Parameters:

list - the list to be splitted

Returns:

a Spliterator over the elements in the passed list

Since:

1.8