Package groovy.lang
Class EmptyRange<T extends Comparable>
- java.lang.Object
-
- java.util.AbstractCollection<E>
-
- java.util.AbstractList<T>
-
- groovy.lang.EmptyRange<T>
-
- All Implemented Interfaces:
Range<T>,Iterable<T>,Collection<T>,List<T>
public class EmptyRange<T extends Comparable> extends AbstractList<T> implements Range<T>
Constructing Ranges like 0..<0
-
-
Field Summary
Fields Modifier and Type Field Description protected TatThe value at which the range originates (may benull).-
Fields inherited from class java.util.AbstractList
modCount
-
-
Constructor Summary
Constructors Constructor Description EmptyRange(T at)Creates a newEmptyRange.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description booleanadd(T o)Always throwsUnsupportedOperationExceptionfor an empty range.booleanaddAll(int index, Collection<? extends T> c)Always throwsUnsupportedOperationExceptionfor an empty range.booleanaddAll(Collection<? extends T> c)Always throwsUnsupportedOperationExceptionfor an empty range.booleancontainsWithinBounds(Object o)Never true for an empty range.Tget(int index)Always throwsIndexOutOfBoundsExceptionfor an empty range.TgetFrom()The lower value in the range.TgetTo()The upper value in the range.Stringinspect()booleanisReverse()Never true for an empty range.Tremove(int index)Always throwsUnsupportedOperationExceptionfor an empty range.booleanremove(Object o)Always throwsUnsupportedOperationExceptionfor an empty range.booleanremoveAll(Collection<?> c)Always throwsUnsupportedOperationExceptionfor an empty range.booleanretainAll(Collection<?> c)Always throwsUnsupportedOperationExceptionfor an empty range.Tset(int index, T element)Always throwsUnsupportedOperationExceptionfor an empty range.intsize()Always 0 for an empty range.List<T>step(int step)Always returns an empty list for an empty range.voidstep(int step, Closure closure)Always does nothing for an empty range.StringtoString()-
Methods inherited from class java.util.AbstractList
add, clear, equals, hashCode, indexOf, iterator, lastIndexOf, listIterator, listIterator, removeRange, subList
-
Methods inherited from class java.util.AbstractCollection
contains, containsAll, isEmpty, toArray, toArray
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface java.util.Collection
parallelStream, removeIf, stream, toArray
-
Methods inherited from interface java.util.List
add, clear, contains, containsAll, equals, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, replaceAll, sort, spliterator, subList, toArray, toArray
-
-
-
-
Field Detail
-
at
protected T extends Comparable at
The value at which the range originates (may benull).
-
-
Constructor Detail
-
EmptyRange
public EmptyRange(T at)
Creates a newEmptyRange.- Parameters:
at- the value at which the range starts (may benull).
-
-
Method Detail
-
getFrom
public T getFrom()
The lower value in the range.- Specified by:
getFromin interfaceRange<T extends Comparable>- Returns:
- the lower value in the range.
-
getTo
public T getTo()
The upper value in the range.- Specified by:
getToin interfaceRange<T extends Comparable>- Returns:
- the upper value in the range
-
isReverse
public boolean isReverse()
Never true for an empty range.- Specified by:
isReversein interfaceRange<T extends Comparable>- Returns:
false
-
containsWithinBounds
public boolean containsWithinBounds(Object o)
Never true for an empty range.- Specified by:
containsWithinBoundsin interfaceRange<T extends Comparable>- Parameters:
o- the object to check against the boundaries of the range- Returns:
false
-
inspect
public String inspect()
-
toString
public String toString()
- Overrides:
toStringin classAbstractCollection<T extends Comparable>
-
size
public int size()
Always 0 for an empty range.- Specified by:
sizein interfaceCollection<T extends Comparable>- Specified by:
sizein interfaceList<T extends Comparable>- Specified by:
sizein classAbstractCollection<T extends Comparable>- Returns:
- 0
-
get
public T get(int index)
Always throwsIndexOutOfBoundsExceptionfor an empty range.- Specified by:
getin interfaceList<T extends Comparable>- Specified by:
getin classAbstractList<T extends Comparable>- Throws:
IndexOutOfBoundsException- always
-
add
public boolean add(T o)
Always throwsUnsupportedOperationExceptionfor an empty range.- Specified by:
addin interfaceCollection<T extends Comparable>- Specified by:
addin interfaceList<T extends Comparable>- Overrides:
addin classAbstractList<T extends Comparable>- Throws:
UnsupportedOperationException- always
-
addAll
public boolean addAll(int index, Collection<? extends T> c)Always throwsUnsupportedOperationExceptionfor an empty range.- Specified by:
addAllin interfaceList<T extends Comparable>- Overrides:
addAllin classAbstractList<T extends Comparable>- Throws:
UnsupportedOperationException
-
addAll
public boolean addAll(Collection<? extends T> c)
Always throwsUnsupportedOperationExceptionfor an empty range.- Specified by:
addAllin interfaceCollection<T extends Comparable>- Specified by:
addAllin interfaceList<T extends Comparable>- Overrides:
addAllin classAbstractCollection<T extends Comparable>- Throws:
UnsupportedOperationException
-
remove
public boolean remove(Object o)
Always throwsUnsupportedOperationExceptionfor an empty range.- Specified by:
removein interfaceCollection<T extends Comparable>- Specified by:
removein interfaceList<T extends Comparable>- Overrides:
removein classAbstractCollection<T extends Comparable>- Throws:
UnsupportedOperationException
-
remove
public T remove(int index)
Always throwsUnsupportedOperationExceptionfor an empty range.- Specified by:
removein interfaceList<T extends Comparable>- Overrides:
removein classAbstractList<T extends Comparable>- Throws:
UnsupportedOperationException
-
removeAll
public boolean removeAll(Collection<?> c)
Always throwsUnsupportedOperationExceptionfor an empty range.- Specified by:
removeAllin interfaceCollection<T extends Comparable>- Specified by:
removeAllin interfaceList<T extends Comparable>- Overrides:
removeAllin classAbstractCollection<T extends Comparable>- Throws:
UnsupportedOperationException
-
retainAll
public boolean retainAll(Collection<?> c)
Always throwsUnsupportedOperationExceptionfor an empty range.- Specified by:
retainAllin interfaceCollection<T extends Comparable>- Specified by:
retainAllin interfaceList<T extends Comparable>- Overrides:
retainAllin classAbstractCollection<T extends Comparable>- Throws:
UnsupportedOperationException
-
set
public T set(int index, T element)
Always throwsUnsupportedOperationExceptionfor an empty range.- Specified by:
setin interfaceList<T extends Comparable>- Overrides:
setin classAbstractList<T extends Comparable>- Throws:
UnsupportedOperationException
-
step
public void step(int step, Closure closure)Always does nothing for an empty range.- Specified by:
stepin interfaceRange<T extends Comparable>- Parameters:
step- the amount by which to step. If negative, steps through the range backwards.closure- theClosureto call
-
step
public List<T> step(int step)
Always returns an empty list for an empty range.- Specified by:
stepin interfaceRange<T extends Comparable>- Parameters:
step- the amount by which to step. If negative, steps through the range backwards.- Returns:
- the list formed by stepping through the range by the indicated interval.
-
-