|
Groovy 2.2.0 | |||||||
FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object groovy.lang.ListWithDefault
public final class ListWithDefault extends Object
A wrapper for List which automatically grows the list when either get(int) or
getAt(int) is called with an index greater than or equal to size()
.
Method Summary | |
---|---|
boolean
|
add(Object t)
|
void
|
add(int i, Object t)
|
boolean
|
addAll(Collection ts)
|
boolean
|
addAll(int i, Collection ts)
|
void
|
clear()
|
boolean
|
contains(Object o)
|
boolean
|
containsAll(Collection objects)
|
boolean
|
equals(Object obj)
|
Object
|
get(int index)
Returns the element at the given index but grows the list if needed. |
Object
|
getAt(int index)
Overwrites subscript operator handling by redirecting to get(int). |
List
|
getDelegate()
|
Closure
|
getInitClosure()
|
int
|
hashCode()
|
int
|
indexOf(Object o)
|
boolean
|
isEmpty()
|
boolean
|
isLazyDefaultValues()
|
Iterator
|
iterator()
|
int
|
lastIndexOf(Object o)
|
ListIterator
|
listIterator()
|
ListIterator
|
listIterator(int i)
|
static List
|
newInstance(List items, boolean lazyDefaultValues, Closure initClosure)
|
boolean
|
remove(Object o)
|
Object
|
remove(int i)
|
boolean
|
removeAll(Collection objects)
|
boolean
|
retainAll(Collection objects)
|
Object
|
set(int i, Object t)
|
int
|
size()
|
List
|
subList(int fromIndex, int toIndex)
|
Object[]
|
toArray()
|
Object[]
|
toArray(Object[] ts)
|
Methods inherited from class Object | |
---|---|
wait, wait, wait, equals, toString, hashCode, getClass, notify, notifyAll |
Method Detail |
---|
public boolean add(Object t)
public void add(int i, Object t)
public boolean addAll(Collection ts)
public boolean addAll(int i, Collection ts)
public void clear()
public boolean contains(Object o)
public boolean containsAll(Collection objects)
@Overridepublic int hashCode() { public boolean equals(Object obj)
public Object get(int index)
index
is
greater than or equal to size()
, the list will grow to the new size and a default value calculated
using the initClosure
will be used to populate the missing value and returned.
If lazyDefaultValues
is true
any gaps when growing the list are filled
with nulls. Subsequent attempts to retrieve items from the list from those gap index values
will, upon finding null, call the initClosure
to populate the list for the
given list value. Hence, when in this mode, nulls cannot be stored in this list.
If lazyDefaultValues
is false
any gaps when growing the list are filled
eagerly by calling the initClosure
for all gap indexes during list growth.
No calls to initClosure
are made except during list growth and it is ok to
store null values in the list when in this mode.
This implementation breaks
the contract of List.get as it a) possibly modifies the underlying list and b) does
NOT throw an IndexOutOfBoundsException when index < 0 || index >= size()
.
index
- an index (might be greater or equal to size()
, or smaller than 0)index
or the default value
public Object getAt(int index)
index
- an index (might be greater or equal to size()
, or smaller than 0)index
or the default value
public List getDelegate()
public Closure getInitClosure()
@Override* Returns a view of a portion of this list. This method returns a list with the same public int hashCode()
public int indexOf(Object o)
public boolean isEmpty()
public boolean isLazyDefaultValues()
public Iterator iterator()
public int lastIndexOf(Object o)
public ListIterator listIterator()
public ListIterator listIterator(int i)
public static List newInstance(List items, boolean lazyDefaultValues, Closure initClosure)
public boolean remove(Object o)
public Object remove(int i)
public boolean removeAll(Collection objects)
public boolean retainAll(Collection objects)
public Object set(int i, Object t)
public int size()
public List subList(int fromIndex, int toIndex)
public Object[] toArray()
public Object[] toArray(Object[] ts)
Copyright © 2003-2013 The Codehaus. All rights reserved.