Class ReferenceLists.Singleton<K>
- All Implemented Interfaces:
ObjectIterable<K>,ReferenceCollection<K>,ReferenceList<K>,Stack<K>,Serializable,Cloneable,Iterable<K>,Collection<K>,List<K>,RandomAccess
- Enclosing class:
- ReferenceLists
public static class ReferenceLists.Singleton<K> extends AbstractReferenceList<K> implements RandomAccess, Serializable, Cloneable
This class may be useful to implement your own in case you subclass a type-specific list.
- See Also:
- Serialized Form
-
Nested Class Summary
Nested classes/interfaces inherited from class it.unimi.dsi.fastutil.objects.AbstractReferenceList
AbstractReferenceList.ReferenceSubList<K> -
Method Summary
Modifier and Type Method Description booleanaddAll(int i, Collection<? extends K> c)Adds all of the elements in the specified collection to this list (optional operation).booleanaddAll(Collection<? extends K> c)voidaddElements(int index, K[] a)Add (hopefully quickly) elements to this type-specific list.voidaddElements(int index, K[] a, int offset, int length)Add (hopefully quickly) elements to this type-specific list.voidclear()Objectclone()booleancontains(Object k)Returns true if this list contains the specified element.Kget(int i)ObjectListIterator<K>iterator()Returns a type-specific iterator on the elements of this collection.ObjectListIterator<K>listIterator()Returns a type-specific list iterator on the list.ObjectListIterator<K>listIterator(int i)Returns a type-specific list iterator on the list starting at a given index.Kremove(int i)booleanremove(Object k)booleanremoveAll(Collection<?> c)voidremoveElements(int from, int to)Removes (hopefully quickly) elements of this type-specific list.booleanretainAll(Collection<?> c)voidsetElements(int index, K[] a)Set (hopefully quickly) elements to match the array given.voidsetElements(int index, K[] a, int offset, int length)Set (hopefully quickly) elements to match the array given.voidsetElements(K[] a)Set (hopefully quickly) elements to match the array given.intsize()voidsize(int size)Sets the size of this list.voidsort(Comparator<? super K> comparator)ReferenceList<K>subList(int from, int to)Returns a type-specific view of the portion of this list from the indexfrom, inclusive, to the indexto, exclusive.Object[]toArray()voidunstableSort(Comparator<? super K> comparator)Sorts this list using a sort not assured to be stable.Methods inherited from class it.unimi.dsi.fastutil.objects.AbstractReferenceList
add, add, equals, getElements, hashCode, indexOf, lastIndexOf, peek, pop, push, set, top, toStringMethods inherited from interface java.util.List
containsAll, isEmpty, replaceAll, spliterator, toArray
-
Method Details
-
get
-
remove
- Specified by:
removein interfaceCollection<K>- Specified by:
removein interfaceList<K>- Overrides:
removein classAbstractCollection<K>
-
remove
Description copied from class:AbstractReferenceListThis implementation always throws an
UnsupportedOperationException. -
contains
Description copied from class:AbstractReferenceListReturns true if this list contains the specified element.This implementation delegates to
indexOf().- Specified by:
containsin interfaceCollection<K>- Specified by:
containsin interfaceList<K>- Overrides:
containsin classAbstractReferenceList<K>- See Also:
List.contains(Object)
-
toArray
- Specified by:
toArrayin interfaceCollection<K>- Specified by:
toArrayin interfaceList<K>- Overrides:
toArrayin classAbstractCollection<K>
-
listIterator
Description copied from class:AbstractReferenceListReturns a type-specific list iterator on the list.This implementation delegates to
listIterator(0).- Specified by:
listIteratorin interfaceList<K>- Specified by:
listIteratorin interfaceReferenceList<K>- Overrides:
listIteratorin classAbstractReferenceList<K>- See Also:
List.listIterator()
-
iterator
Description copied from class:AbstractReferenceListReturns a type-specific iterator on the elements of this collection.Note that this specification strengthens the one given in
Iterable.iterator(), which was already strengthened in the corresponding type-specific class, but was weakened by the fact that this interface extendsCollection.This implementation delegates to
AbstractReferenceList.listIterator().- Specified by:
iteratorin interfaceCollection<K>- Specified by:
iteratorin interfaceIterable<K>- Specified by:
iteratorin interfaceList<K>- Specified by:
iteratorin interfaceObjectIterable<K>- Specified by:
iteratorin interfaceReferenceCollection<K>- Specified by:
iteratorin interfaceReferenceList<K>- Overrides:
iteratorin classAbstractReferenceList<K>- Returns:
- a type-specific iterator on the elements of this collection.
- See Also:
Iterable.iterator()
-
listIterator
Description copied from class:AbstractReferenceListReturns a type-specific list iterator on the list starting at a given index.This implementation is based on the random-access methods.
- Specified by:
listIteratorin interfaceList<K>- Specified by:
listIteratorin interfaceReferenceList<K>- Overrides:
listIteratorin classAbstractReferenceList<K>- See Also:
List.listIterator(int)
-
subList
Description copied from interface:ReferenceListReturns a type-specific view of the portion of this list from the indexfrom, inclusive, to the indexto, exclusive.Note that this specification strengthens the one given in
List.subList(int,int).- Specified by:
subListin interfaceList<K>- Specified by:
subListin interfaceReferenceList<K>- Overrides:
subListin classAbstractReferenceList<K>- See Also:
List.subList(int,int)
-
addAll
Description copied from class:AbstractReferenceListAdds all of the elements in the specified collection to this list (optional operation). -
addAll
Description copied from class:AbstractReferenceListThis implementation delegates to the type-specific version of
List.addAll(int, Collection).- Specified by:
addAllin interfaceCollection<K>- Specified by:
addAllin interfaceList<K>- Overrides:
addAllin classAbstractReferenceList<K>
-
removeAll
- Specified by:
removeAllin interfaceCollection<K>- Specified by:
removeAllin interfaceList<K>- Overrides:
removeAllin classAbstractCollection<K>
-
retainAll
- Specified by:
retainAllin interfaceCollection<K>- Specified by:
retainAllin interfaceList<K>- Overrides:
retainAllin classAbstractCollection<K>
-
sort
-
unstableSort
Description copied from interface:ReferenceListSorts this list using a sort not assured to be stable. This differs fromList.sort(java.util.Comparator)in that the results are not assured to be stable, but may be a bit faster.Unless a subclass specifies otherwise, the results of the method if the list is concurrently modified during the sort are unspecified.
- Specified by:
unstableSortin interfaceReferenceList<K>
-
removeElements
public void removeElements(int from, int to)Description copied from class:AbstractReferenceListRemoves (hopefully quickly) elements of this type-specific list.This is a trivial iterator-based implementation. It is expected that implementations will override this method with a more optimized version.
- Specified by:
removeElementsin interfaceReferenceList<K>- Overrides:
removeElementsin classAbstractReferenceList<K>- Parameters:
from- the start index (inclusive).to- the end index (exclusive).
-
addElements
Description copied from class:AbstractReferenceListAdd (hopefully quickly) elements to this type-specific list.This implementation delegates to the analogous method for array fragments.
- Specified by:
addElementsin interfaceReferenceList<K>- Overrides:
addElementsin classAbstractReferenceList<K>- Parameters:
index- the index at which to add elements.a- the array containing the elements.
-
addElements
Description copied from class:AbstractReferenceListAdd (hopefully quickly) elements to this type-specific list.This is a trivial iterator-based implementation. It is expected that implementations will override this method with a more optimized version.
- Specified by:
addElementsin interfaceReferenceList<K>- Overrides:
addElementsin classAbstractReferenceList<K>- Parameters:
index- the index at which to add elements.a- the array containing the elements.offset- the offset of the first element to add.length- the number of elements to add.
-
setElements
Description copied from interface:ReferenceListSet (hopefully quickly) elements to match the array given.- Specified by:
setElementsin interfaceReferenceList<K>- Parameters:
a- the array containing the elements.
-
setElements
Description copied from interface:ReferenceListSet (hopefully quickly) elements to match the array given.- Specified by:
setElementsin interfaceReferenceList<K>- Parameters:
index- the index at which to start setting elements.a- the array containing the elements.
-
setElements
Description copied from interface:ReferenceListSet (hopefully quickly) elements to match the array given. Sets each in this list to the corresponding elements in the array, as if by
However, the exact implementation may be more efficient, taking into account whether random access is faster or not, or at the discretion of subclasses, abuse internals.ListIterator iter = listIterator(index); int i = 0; while (i < length) { iter.next(); iter.set(a[offset + i++]); }- Specified by:
setElementsin interfaceReferenceList<K>- Parameters:
index- the index at which to start setting elements.a- the array containing the elementsoffset- the offset of the first element to add.length- the number of elements to add.
-
size
public int size()- Specified by:
sizein interfaceCollection<K>- Specified by:
sizein interfaceList<K>- Specified by:
sizein classAbstractCollection<K>
-
size
public void size(int size)Description copied from interface:ReferenceListSets the size of this list.If the specified size is smaller than the current size, the last elements are discarded. Otherwise, they are filled with 0/
null/false.- Specified by:
sizein interfaceReferenceList<K>- Overrides:
sizein classAbstractReferenceList<K>- Parameters:
size- the new size.
-
clear
public void clear()Description copied from class:AbstractReferenceListThis implementation delegates to
AbstractReferenceList.removeElements(int, int).- Specified by:
clearin interfaceCollection<K>- Specified by:
clearin interfaceList<K>- Overrides:
clearin classAbstractReferenceList<K>
-
clone
-