pack-priv final Class EmptyList<T>

Overrides org.eclipse.collections.impl.list.fixed.AbstractMemoryEfficientMutableList.clone.

Implements org.eclipse.collections.api.list.MutableList.clone.

Doc from java.lang.Object.clone.

Creates and returns a copy of this object. The precise meaning of "copy" may depend on the class of the object. The general intent is that, for any object x, the expression:

x.clone() != x

x.clone().getClass() == x.getClass()

x.clone().equals(x)

By convention, the returned object should be obtained by calling super.clone. If a class and all of its superclasses (except Object) obey this convention, it will be the case that x.clone().getClass() == x.getClass().

By convention, the object returned by this method should be independent of this object (which is being cloned). To achieve this independence, it may be necessary to modify one or more fields of the object returned by super.clone before returning it. Typically, this means copying any mutable objects that comprise the internal "deep structure" of the object being cloned and replacing the references to these objects with references to the copies. If a class contains only primitive fields or references to immutable objects, then it is usually the case that no fields in the object returned by super.clone need to be modified.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.contains.

Implements java.util.Collection.contains, org.eclipse.collections.api.RichIterable.contains, java.util.List.contains.

Doc from java.util.List.contains.

Returns true if this list contains the specified element. More formally, returns true if and only if this list contains at least one element e such that Objects.equals(o, e).

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.each.

Implements org.eclipse.collections.api.RichIterable.each.

Doc from org.eclipse.collections.api.RichIterable.each.

The procedure is executed for each element in the iterable.

Example using a Java 8 lambda expression:

people.each(person -> LOGGER.info(person.getName()));

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.forEachWith.

Implements org.eclipse.collections.api.InternalIterable.forEachWith.

Doc from org.eclipse.collections.api.InternalIterable.forEachWith.

The procedure2 is evaluated for each element in the iterable with the specified parameter provided as the second argument.

Example using a Java 8 lambda:

people.forEachWith((Person person, Person other) ->
    {
        if (person.isRelatedTo(other))
        {
             LOGGER.info(person.getName());
        }
    }, fred);

Example using an anonymous inner class:

people.forEachWith(new Procedure2<Person, Person>()
{
    public void value(Person person, Person other)
    {
        if (person.isRelatedTo(other))
        {
             LOGGER.info(person.getName());
        }
    }
}, fred);

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.forEachWithIndex.

Implements org.eclipse.collections.api.InternalIterable.forEachWithIndex, org.eclipse.collections.api.ordered.OrderedIterable.forEachWithIndex.

Doc from org.eclipse.collections.api.InternalIterable.forEachWithIndex.

Iterates over the iterable passing each element and the current relative int index to the specified instance of ObjectIntProcedure.

Example using a Java 8 lambda:

people.forEachWithIndex((Person person, int index) -> LOGGER.info("Index: " + index + " person: " + person.getName()));

Example using an anonymous inner class:

people.forEachWithIndex(new ObjectIntProcedure<Person>()
{
    public void value(Person person, int index)
    {
        LOGGER.info("Index: " + index + " person: " + person.getName());
    }
});

Annotations

@Override

Implements java.util.List.get, org.eclipse.collections.api.list.ListIterable.get.

Doc from java.util.List.get.

Returns the element at the specified position in this list.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.getFirst.

Overrides default org.eclipse.collections.api.list.MutableList.getFirst.

Implements org.eclipse.collections.api.RichIterable.getFirst.

Doc from org.eclipse.collections.api.list.MutableList.getFirst.

This default override exists because java.util.List added a default getFirst() method in Java 21.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.getLast.

Overrides default org.eclipse.collections.api.list.MutableList.getLast.

Implements org.eclipse.collections.api.RichIterable.getLast.

Doc from org.eclipse.collections.api.list.MutableList.getLast.

This default override exists because java.util.List added a default getLast() method in Java 21.

Annotations

@Override

Overrides default org.eclipse.collections.api.RichIterable.getOnly.

Doc from org.eclipse.collections.api.RichIterable.getOnly.

Returns the element if the iterable has exactly one element. Otherwise, throw IllegalStateException.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.iterator.

Implements java.util.Collection.iterator, java.lang.Iterable.iterator, java.util.List.iterator.

Doc from java.util.List.iterator.

Returns an iterator over the elements in this list in proper sequence.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.fixed.AbstractMemoryEfficientMutableList.listIterator.

Implements java.util.List.listIterator, org.eclipse.collections.api.list.ListIterable.listIterator.

Doc from java.util.List.listIterator.

Returns a list iterator over the elements in this list (in proper sequence).

Annotations

@Override

Overrides org.eclipse.collections.impl.list.fixed.AbstractMemoryEfficientMutableList.listIterator.

Implements java.util.List.listIterator, org.eclipse.collections.api.list.ListIterable.listIterator.

Doc from java.util.List.listIterator.

Returns a list iterator over the elements in this list (in proper sequence), starting at the specified position in the list. The specified index indicates the first element that would be returned by an initial call to next. An initial call to previous would return the element with the specified index minus one.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.max.

Implements org.eclipse.collections.api.RichIterable.max.

Doc from org.eclipse.collections.api.RichIterable.max.

Returns the maximum element out of this container based on the comparator.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.max.

Implements org.eclipse.collections.api.RichIterable.max, org.eclipse.collections.api.ordered.OrderedIterable.max.

Doc from org.eclipse.collections.api.RichIterable.max.

Returns the maximum element out of this container based on the natural order.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.maxBy.

Implements org.eclipse.collections.api.RichIterable.maxBy.

Doc from org.eclipse.collections.api.RichIterable.maxBy.

Returns the maximum elements out of this container based on the natural order of the attribute returned by Function.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.min.

Implements org.eclipse.collections.api.RichIterable.min.

Doc from org.eclipse.collections.api.RichIterable.min.

Returns the minimum element out of this container based on the comparator.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.min.

Implements org.eclipse.collections.api.RichIterable.min, org.eclipse.collections.api.ordered.OrderedIterable.min.

Doc from org.eclipse.collections.api.RichIterable.min.

Returns the minimum element out of this container based on the natural order.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.minBy.

Implements org.eclipse.collections.api.RichIterable.minBy.

Doc from org.eclipse.collections.api.RichIterable.minBy.

Returns the minimum elements out of this container based on the natural order of the attribute returned by Function.

Annotations

@Override

Overrides default java.util.List.replaceAll.

Doc from java.util.List.replaceAll.

Replaces each element of this list with the result of applying the operator to that element (optional operation). Errors or runtime exceptions thrown by the operator are relayed to the caller.

Annotations

@Override

Since

10.0 - Overridden for efficiency

Implements java.util.List.set.

Doc from java.util.List.set.

Replaces the element at the specified position in this list with the specified element (optional operation).

Annotations

@Override

Implements java.util.Collection.size, org.eclipse.collections.api.RichIterable.size, java.util.List.size.

Doc from java.util.List.size.

Returns the number of elements in this list. If this list contains more than Integer.MAX_VALUE elements, returns Integer.MAX_VALUE.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.fixed.AbstractMemoryEfficientMutableList.sort.

Overrides default java.util.List.sort.

Doc from org.eclipse.collections.impl.list.fixed.AbstractMemoryEfficientMutableList.sort.

This method checks if comparator is null and use a ComparableComparator if it is.

Annotations

@Override

Since

10.0 - Overridden for efficiency

Overrides default org.eclipse.collections.api.list.FixedSizeList.sortThis, org.eclipse.collections.api.list.MutableList.sortThis.

Doc from org.eclipse.collections.api.list.MutableList.sortThis.

Sorts the internal data structure of this list and returns the list itself as a convenience.

Annotations

@Override

Overrides default org.eclipse.collections.api.list.MutableList.sortThisBy.

Doc from org.eclipse.collections.api.list.MutableList.sortThisBy.

Sorts the internal data structure of this list based on the natural order of the attribute returned by function.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.sortThisByBoolean.

Implements org.eclipse.collections.api.list.MutableList.sortThisByBoolean.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.sortThisByByte.

Implements org.eclipse.collections.api.list.MutableList.sortThisByByte.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.sortThisByChar.

Implements org.eclipse.collections.api.list.MutableList.sortThisByChar.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.sortThisByDouble.

Implements org.eclipse.collections.api.list.MutableList.sortThisByDouble.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.sortThisByFloat.

Implements org.eclipse.collections.api.list.MutableList.sortThisByFloat.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.sortThisByInt.

Implements org.eclipse.collections.api.list.MutableList.sortThisByInt.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.sortThisByLong.

Implements org.eclipse.collections.api.list.MutableList.sortThisByLong.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.sortThisByShort.

Implements org.eclipse.collections.api.list.MutableList.sortThisByShort.

Annotations

@Override

Overrides default org.eclipse.collections.api.list.MutableList.toImmutable.

Implements org.eclipse.collections.api.collection.MutableCollection.toImmutable.

Doc from org.eclipse.collections.api.list.MutableList.toImmutable.

Returns an immutable copy of this list. If the list is immutable, it returns itself.

Annotations

@Override

Overrides default org.eclipse.collections.api.list.MutableList.with.

Implements org.eclipse.collections.api.list.FixedSizeList.with, org.eclipse.collections.api.collection.MutableCollection.with.

Doc from org.eclipse.collections.api.collection.FixedSizeCollection.with.

This method allows fixed size collections the ability to add elements to their existing elements. A new instance of MutableCollection is returned containing the elements of the original collection with the new element added. Implementations will return a new FixedSizeCollection where possible. In order to use this method properly with mutable and fixed size collections the following approach must be taken:

MutableCollection<String> list;
list = list.with("1");
list = list.with("2");
return list;

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.zip.

Implements org.eclipse.collections.api.list.MutableList.zip, org.eclipse.collections.api.collection.MutableCollection.zip, org.eclipse.collections.api.RichIterable.zip.

Doc from org.eclipse.collections.api.RichIterable.zip.

Returns a RichIterable formed from this RichIterable and another RichIterable by combining corresponding elements in pairs. If one of the two RichIterables is longer than the other, its remaining elements are ignored.

Annotations

@Override

Overrides org.eclipse.collections.impl.list.mutable.AbstractMutableList.zipWithIndex.

Implements org.eclipse.collections.api.list.MutableList.zipWithIndex, org.eclipse.collections.api.collection.MutableCollection.zipWithIndex, org.eclipse.collections.api.RichIterable.zipWithIndex.

Doc from org.eclipse.collections.api.RichIterable.zipWithIndex.

Zips this RichIterable with its indices.

Annotations

@Override