it.unimi.dsi.fastutil.objects

Class AbstractReferenceList.ReferenceSubList<K>

java.lang.Object

java.util.AbstractCollection<K>

it.unimi.dsi.fastutil.objects.AbstractReferenceCollection<K>

it.unimi.dsi.fastutil.objects.AbstractReferenceList<K>

it.unimi.dsi.fastutil.objects.AbstractReferenceList.ReferenceSubList<K>

All Implemented Interfaces:

it.unimi.dsi.fastutil.objects.ObjectIterable<K>, ReferenceCollection<K>, ReferenceList<K>, it.unimi.dsi.fastutil.Stack<K>, java.io.Serializable, java.lang.Iterable<K>, java.util.Collection<K>, java.util.List<K>

Direct Known Subclasses:

AbstractReferenceList.ReferenceRandomAccessSubList

Enclosing class:

AbstractReferenceList<K>

public static class AbstractReferenceList.ReferenceSubList<K>
extends AbstractReferenceList<K>
implements java.io.Serializable

A class implementing a sublist view.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class it.unimi.dsi.fastutil.objects.AbstractReferenceList

AbstractReferenceList.ReferenceRandomAccessSubList<K>, AbstractReferenceList.ReferenceSubList<K>

Field Summary

Fields

Modifier and Type	Field and Description
protected int	from Initial (inclusive) index of this sublist.
protected ReferenceList<K>	l The list this sublist restricts.
protected int	to Final (exclusive) index of this sublist.

Constructor Summary

Constructors

Constructor and Description
ReferenceSubList(ReferenceList<K> l, int from, int to)

Method Summary

Modifier and Type	Method and Description
void	add(int index, K k)
boolean	add(K k)
boolean	addAll(int index, java.util.Collection<? extends K> c) Adds all of the elements in the specified collection to this list (optional operation).
void	addElements(int index, K[] a, int offset, int length) Add (hopefully quickly) elements to this type-specific list.
K	get(int index)
void	getElements(int from, java.lang.Object[] a, int offset, int length) Copies (hopefully quickly) elements of this type-specific list into the given array.
it.unimi.dsi.fastutil.objects.ObjectListIterator<K>	listIterator(int index) Returns a type-specific list iterator on the list starting at a given index.
K	remove(int index)
void	removeElements(int from, int to) Removes (hopefully quickly) elements of this type-specific list.
K	set(int index, K k)
void	setElements(int index, K[] a, int offset, int length) Set (hopefully quickly) elements to match the array given.
int	size()
it.unimi.dsi.fastutil.objects.ObjectSpliterator<K>	spliterator() Returns a type-specific spliterator on the elements of this list.
ReferenceList<K>	subList(int from, int to) Returns a type-specific view of the portion of this list from the index from, inclusive, to the index to, exclusive.

Methods inherited from class it.unimi.dsi.fastutil.objects.AbstractReferenceList

addAll, addElements, clear, contains, ensureIndex, ensureRestrictedIndex, equals, forEach, hashCode, indexOf, iterator, lastIndexOf, listIterator, peek, pop, push, size, toArray, toArray, top, toString

Methods inherited from class java.util.AbstractCollection

containsAll, isEmpty, remove, removeAll, retainAll

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface it.unimi.dsi.fastutil.objects.ReferenceList

addAll, addAll, of, of, of, of, of, setElements, setElements, sort, unstableSort

Methods inherited from interface java.util.List

containsAll, isEmpty, remove, removeAll, replaceAll, retainAll

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface it.unimi.dsi.fastutil.Stack

isEmpty

Field Detail

l

protected final ReferenceList<K> l

The list this sublist restricts.

from

protected final int from

Initial (inclusive) index of this sublist.

to

protected int to

Final (exclusive) index of this sublist.

Constructor Detail

ReferenceSubList

public ReferenceSubList(ReferenceList<K> l,
                        int from,
                        int to)

Method Detail

add

public boolean add(K k)

Description copied from class: AbstractReferenceList

Specified by:

add in interface java.util.Collection<K>

Specified by:

add in interface java.util.List<K>

Overrides:

add in class AbstractReferenceList<K>

add

public void add(int index,
                K k)

Description copied from class: AbstractReferenceList

Specified by:

add in interface java.util.List<K>

Overrides:

add in class AbstractReferenceList<K>

addAll

public boolean addAll(int index,
                      java.util.Collection<? extends K> c)

Description copied from class: AbstractReferenceList

Adds all of the elements in the specified collection to this list (optional operation).

Specified by:

addAll in interface java.util.List<K>

Overrides:

addAll in class AbstractReferenceList<K>

get

public K get(int index)

Specified by:

get in interface java.util.List<K>

remove

public K remove(int index)

Description copied from class: AbstractReferenceList

Specified by:

remove in interface java.util.List<K>

Overrides:

remove in class AbstractReferenceList<K>

set

public K set(int index,
             K k)

Description copied from class: AbstractReferenceList

Specified by:

set in interface java.util.List<K>

Overrides:

set in class AbstractReferenceList<K>

size

public int size()

Specified by:

size in interface java.util.Collection<K>

Specified by:

size in interface java.util.List<K>

Specified by:

size in class java.util.AbstractCollection<K>

getElements

public void getElements(int from,
                        java.lang.Object[] a,
                        int offset,
                        int length)

Description copied from class: AbstractReferenceList

Copies (hopefully quickly) elements of this type-specific list into the given array.

This is a trivial iterator-based implementation. It is expected that implementations will override this method with a more optimized version.

Specified by:

getElements in interface ReferenceList<K>

Overrides:

getElements in class AbstractReferenceList<K>

Parameters:

from - the start index (inclusive).

a - the destination array.

offset - the offset into the destination array where to store the first element copied.

length - the number of elements to be copied.

removeElements

public void removeElements(int from,
                           int to)

Description copied from class: AbstractReferenceList

Removes (hopefully quickly) elements of this type-specific list.

This is a trivial iterator-based based implementation. It is expected that implementations will override this method with a more optimized version.

Specified by:

removeElements in interface ReferenceList<K>

Overrides:

removeElements in class AbstractReferenceList<K>

Parameters:

from - the start index (inclusive).

to - the end index (exclusive).

addElements

public void addElements(int index,
                        K[] a,
                        int offset,
                        int length)

Description copied from class: AbstractReferenceList

Add (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:

addElements in interface ReferenceList<K>

Overrides:

addElements in class AbstractReferenceList<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

public void setElements(int index,
                        K[] a,
                        int offset,
                        int length)

Description copied from interface: ReferenceList

Set (hopefully quickly) elements to match the array given. Sets each in this list to the corresponding elements in the array, as if by

 ListIterator iter = listIterator(index);
 int i = 0;
 while (i < length) {
   iter.next();
   iter.set(a[offset + i++]);
 }
 

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.

Specified by:

setElements in interface ReferenceList<K>

Overrides:

setElements in class AbstractReferenceList<K>

Parameters:

index - the index at which to start setting elements.

a - the array containing the elements

offset - the offset of the first element to add.

length - the number of elements to add.

listIterator

public it.unimi.dsi.fastutil.objects.ObjectListIterator<K> listIterator(int index)

Description copied from class: AbstractReferenceList

Returns a type-specific list iterator on the list starting at a given index.

Specified by:

listIterator in interface ReferenceList<K>

Specified by:

listIterator in interface java.util.List<K>

Overrides:

listIterator in class AbstractReferenceList<K>

See Also:

List.listIterator(int)

spliterator

public it.unimi.dsi.fastutil.objects.ObjectSpliterator<K> spliterator()

Description copied from interface: ReferenceList

Returns a type-specific spliterator on the elements of this list.

List spliterators must report at least Spliterator.SIZED and Spliterator.ORDERED.

See List.spliterator() for more documentation on the requirements of the returned spliterator.

Specified by:

spliterator in interface it.unimi.dsi.fastutil.objects.ObjectIterable<K>

Specified by:

spliterator in interface ReferenceCollection<K>

Specified by:

spliterator in interface ReferenceList<K>

Specified by:

spliterator in interface java.lang.Iterable<K>

Specified by:

spliterator in interface java.util.Collection<K>

Specified by:

spliterator in interface java.util.List<K>

Returns:

a type-specific spliterator on the elements of this collection.

subList

public ReferenceList<K> subList(int from,
                                int to)

Description copied from interface: ReferenceList

Returns a type-specific view of the portion of this list from the index from, inclusive, to the index to, exclusive.

Specified by:

subList in interface ReferenceList<K>

Specified by:

subList in interface java.util.List<K>

Overrides:

subList in class AbstractReferenceList<K>

See Also:

List.subList(int,int)