it.unimi.dsi.fastutil.ints

Class IntBigLists.ListBigList

java.lang.Object

java.util.AbstractCollection<java.lang.Integer>

it.unimi.dsi.fastutil.ints.AbstractIntCollection

it.unimi.dsi.fastutil.ints.AbstractIntBigList

it.unimi.dsi.fastutil.ints.IntBigLists.ListBigList

All Implemented Interfaces:

BigList<java.lang.Integer>, IntBigList, IntCollection, IntIterable, IntStack, Size64, Stack<java.lang.Integer>, java.io.Serializable, java.lang.Comparable<BigList<? extends java.lang.Integer>>, java.lang.Iterable<java.lang.Integer>, java.util.Collection<java.lang.Integer>

Enclosing class:

IntBigLists

public static class IntBigLists.ListBigList
extends AbstractIntBigList
implements java.io.Serializable

A class exposing a list as a big list.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class it.unimi.dsi.fastutil.ints.AbstractIntBigList

AbstractIntBigList.IntSubList

Method Summary

Modifier and Type	Method and Description
boolean	add(int key) Ensures that this collection contains the specified element (optional operation).
void	add(long index, int key) Inserts the specified element at the specified position in this type-specific big list (optional operation).
boolean	addAll(java.util.Collection<? extends java.lang.Integer> c) This implementation delegates to the type-specific version of BigList.addAll(long, Collection).
boolean	addAll(IntBigList c) Appends all of the elements in the specified type-specific big list to the end of this type-specific big list (optional operation).
boolean	addAll(IntCollection c) Adds all elements of the given type-specific collection to this collection.
boolean	addAll(long index, java.util.Collection<? extends java.lang.Integer> c) Adds all of the elements in the specified collection to this list (optional operation).
boolean	addAll(long index, IntBigList c) Inserts all of the elements in the specified type-specific big list into this type-specific big list at the specified position (optional operation).
boolean	addAll(long index, IntCollection c) Inserts all of the elements in the specified type-specific collection into this type-specific big list at the specified position (optional operation).
void	clear() This implementation delegates to AbstractIntBigList.removeElements(long, long).
boolean	contains(int key) Returns true if this list contains the specified element.
boolean	containsAll(java.util.Collection<?> c)
boolean	containsAll(IntCollection c) Checks whether this collection contains all elements from the given type-specific collection.
int	getInt(long index) Returns the element at the specified position.
int	hashCode() Returns the hash code for this big list, which is identical to List.hashCode().
long	indexOf(int k) Returns the index of the first occurrence of the specified element in this type-specific big list, or -1 if this big list does not contain the element.
boolean	isEmpty() Checks whether the stack is empty.
IntBigListIterator	iterator() Returns a type-specific iterator on the elements of this collection.
long	lastIndexOf(int k) Returns the index of the last occurrence of the specified element in this type-specific big list, or -1 if this big list does not contain the element.
IntBigListIterator	listIterator() Returns a type-specific big-list iterator on this type-specific big list.
IntBigListIterator	listIterator(long index) Returns a type-specific list iterator on this type-specific big list starting at a given index.
boolean	removeAll(java.util.Collection<?> c)
boolean	removeAll(IntCollection c) Remove from this collection all elements in the given type-specific collection.
void	removeElements(long from, long to) Removes (hopefully quickly) elements of this type-specific big list.
int	removeInt(long index) Removes the element at the specified position.
boolean	retainAll(java.util.Collection<?> c)
boolean	retainAll(IntCollection c) Retains in this collection only elements from the given type-specific collection.
int	set(long index, int k) Replaces the element at the specified position in this big list with the specified element (optional operation).
void	size(long size) Sets the size of this big list.
long	size64() Returns the size of this data structure as a long.
IntBigList	subList(long from, long to) Returns a type-specific view of the portion of this type-specific big list from the index from, inclusive, to the index to, exclusive.
<T> T[]	toArray(T[] a)
int[]	toIntArray() Returns a primitive type array containing the items of this collection.
int[]	toIntArray(int[] a) Deprecated.

Methods inherited from class it.unimi.dsi.fastutil.ints.AbstractIntBigList

add, addElements, addElements, compareTo, equals, get, getElements, indexOf, lastIndexOf, peek, peekInt, pop, popInt, push, push, rem, remove, set, size, top, topInt, toString

Methods inherited from class it.unimi.dsi.fastutil.ints.AbstractIntCollection

add, contains, remove, toArray

Methods inherited from class java.util.AbstractCollection

toArray

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface it.unimi.dsi.fastutil.ints.IntCollection

add, contains, remove, removeIf, removeIf, toArray

Methods inherited from interface java.util.Collection

parallelStream, spliterator, stream, toArray

Methods inherited from interface it.unimi.dsi.fastutil.ints.IntIterable

forEach, forEach

Method Detail

size64

public long size64()

Description copied from interface: Size64

Returns the size of this data structure as a long.

Specified by:

size64 in interface Size64

Returns:

the size of this data structure.

size

public void size(long size)

Description copied from interface: BigList

Sets the size of this big 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:

size in interface BigList<java.lang.Integer>

Overrides:

size in class AbstractIntBigList

Parameters:

size - the new size.

iterator

public IntBigListIterator iterator()

Description copied from class: AbstractIntBigList

Returns 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 extends Collection.

This implementation delegates to AbstractIntBigList.listIterator().

Specified by:

iterator in interface IntBigList

Specified by:

iterator in interface IntCollection

Specified by:

iterator in interface IntIterable

Specified by:

iterator in interface java.lang.Iterable<java.lang.Integer>

Specified by:

iterator in interface java.util.Collection<java.lang.Integer>

Overrides:

iterator in class AbstractIntBigList

Returns:

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

See Also:

Iterable.iterator()

listIterator

public IntBigListIterator listIterator()

Description copied from class: AbstractIntBigList

Returns a type-specific big-list iterator on this type-specific big list.

Note that this specification strengthens the one given in BigList.listIterator().

This implementation delegates to listIterator(0).

Specified by:

listIterator in interface BigList<java.lang.Integer>

Specified by:

listIterator in interface IntBigList

Overrides:

listIterator in class AbstractIntBigList

Returns:

a big-list iterator over the elements in this big list.

See Also:

BigList.listIterator()

listIterator

public IntBigListIterator listIterator(long index)

Description copied from class: AbstractIntBigList

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

Note that this specification strengthens the one given in BigList.listIterator(long).

This implementation is based on the random-access methods.

Specified by:

listIterator in interface BigList<java.lang.Integer>

Specified by:

listIterator in interface IntBigList

Overrides:

listIterator in class AbstractIntBigList

Parameters:

index - index of first element to be returned from the big-list iterator.

Returns:

a big-list iterator of the elements in this big list, starting at the specified position in this big list.

See Also:

BigList.listIterator(long)

addAll

public boolean addAll(long index,
                      java.util.Collection<? extends java.lang.Integer> c)

Description copied from class: AbstractIntBigList

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

Specified by:

addAll in interface BigList<java.lang.Integer>

Overrides:

addAll in class AbstractIntBigList

Parameters:

index - index at which to insert the first element from the specified collection.

c - collection containing elements to be added to this big list.

Returns:

true if this big list changed as a result of the call

See Also:

List.addAll(int, Collection)

subList

public IntBigList subList(long from,
                          long to)

Description copied from interface: IntBigList

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

Note that this specification strengthens the one given in BigList.subList(long,long).

Specified by:

subList in interface BigList<java.lang.Integer>

Specified by:

subList in interface IntBigList

Overrides:

subList in class AbstractIntBigList

Parameters:

from - the starting element (inclusive).

to - the ending element (exclusive).

Returns:

a big sublist view of this big list.

See Also:

BigList.subList(long,long)

contains

public boolean contains(int key)

Description copied from class: AbstractIntBigList

Returns true if this list contains the specified element.

This implementation delegates to indexOf().

Specified by:

contains in interface IntCollection

Overrides:

contains in class AbstractIntBigList

See Also:

Collection.contains(Object)

toIntArray

public int[] toIntArray()

Description copied from interface: IntCollection

Returns a primitive type array containing the items of this collection.

Specified by:

toIntArray in interface IntCollection

Overrides:

toIntArray in class AbstractIntCollection

Returns:

a primitive type array containing the items of this collection.

See Also:

Collection.toArray()

removeElements

public void removeElements(long from,
                           long to)

Description copied from class: AbstractIntBigList

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

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

Specified by:

removeElements in interface IntBigList

Overrides:

removeElements in class AbstractIntBigList

Parameters:

from - the start index (inclusive).

to - the end index (exclusive).

toIntArray

@Deprecated
public int[] toIntArray(int[] a)

Deprecated.

Description copied from class: AbstractIntCollection

Returns a primitive type array containing the items of this collection.

Note that, contrarily to Collection.toArray(Object[]), this methods just writes all elements of this collection: no special value will be added after the last one.

Specified by:

toIntArray in interface IntCollection

Overrides:

toIntArray in class AbstractIntCollection

Parameters:

a - if this array is big enough, it will be used to store this collection.

Returns:

a primitive type array containing the items of this collection.

See Also:

Collection.toArray(Object[])

addAll

public boolean addAll(long index,
                      IntCollection c)

Description copied from class: AbstractIntBigList

Inserts all of the elements in the specified type-specific collection into this type-specific big list at the specified position (optional operation).

This implementation delegates to the type-specific version of AbstractIntBigList.addAll(long, Collection).

Specified by:

addAll in interface IntBigList

Overrides:

addAll in class AbstractIntBigList

See Also:

List.addAll(int,java.util.Collection)

addAll

public boolean addAll(IntCollection c)

Description copied from class: AbstractIntBigList

Adds all elements of the given type-specific collection to this collection.

This implementation delegates to the type-specific version of AbstractIntBigList.addAll(long, Collection).

Specified by:

addAll in interface IntCollection

Overrides:

addAll in class AbstractIntBigList

Parameters:

c - a type-specific collection.

Returns:

true if this collection changed as a result of the call.

See Also:

Collection.addAll(Collection)

addAll

public boolean addAll(long index,
                      IntBigList c)

Description copied from class: AbstractIntBigList

Inserts all of the elements in the specified type-specific big list into this type-specific big list at the specified position (optional operation).

This implementation delegates to the type-specific version of AbstractIntBigList.addAll(long, Collection).

Specified by:

addAll in interface IntBigList

Overrides:

addAll in class AbstractIntBigList

See Also:

List.addAll(int,java.util.Collection)

addAll

public boolean addAll(IntBigList c)

Description copied from class: AbstractIntBigList

Appends all of the elements in the specified type-specific big list to the end of this type-specific big list (optional operation).

This implementation delegates to the type-specific list version of AbstractIntBigList.addAll(long, Collection).

Specified by:

addAll in interface IntBigList

Overrides:

addAll in class AbstractIntBigList

See Also:

List.addAll(int,java.util.Collection)

containsAll

public boolean containsAll(IntCollection c)

Description copied from interface: IntCollection

Checks whether this collection contains all elements from the given type-specific collection.

Specified by:

containsAll in interface IntCollection

Overrides:

containsAll in class AbstractIntCollection

Parameters:

c - a type-specific collection.

Returns:

true if this collection contains all elements of the argument.

See Also:

Collection.containsAll(Collection)

removeAll

public boolean removeAll(IntCollection c)

Description copied from interface: IntCollection

Remove from this collection all elements in the given type-specific collection.

Specified by:

removeAll in interface IntCollection

Overrides:

removeAll in class AbstractIntCollection

Parameters:

c - a type-specific collection.

Returns:

true if this collection changed as a result of the call.

See Also:

Collection.removeAll(Collection)

retainAll

public boolean retainAll(IntCollection c)

Description copied from interface: IntCollection

Retains in this collection only elements from the given type-specific collection.

Specified by:

retainAll in interface IntCollection

Overrides:

retainAll in class AbstractIntCollection

Parameters:

c - a type-specific collection.

Returns:

true if this collection changed as a result of the call.

See Also:

Collection.retainAll(Collection)

add

public void add(long index,
                int key)

Description copied from class: AbstractIntBigList

Inserts the specified element at the specified position in this type-specific big list (optional operation).

This implementation always throws an UnsupportedOperationException.

Specified by:

add in interface IntBigList

Overrides:

add in class AbstractIntBigList

See Also:

BigList.add(long,Object)

add

public boolean add(int key)

Description copied from class: AbstractIntBigList

Ensures that this collection contains the specified element (optional operation).

This implementation always throws an UnsupportedOperationException.

This implementation delegates to the type-specific version of BigList.add(long, Object).

Specified by:

add in interface IntCollection

Overrides:

add in class AbstractIntBigList

See Also:

Collection.add(Object)

getInt

public int getInt(long index)

Description copied from interface: IntBigList

Returns the element at the specified position.

Specified by:

getInt in interface IntBigList

See Also:

BigList.get(long)

indexOf

public long indexOf(int k)

Description copied from interface: IntBigList

Returns the index of the first occurrence of the specified element in this type-specific big list, or -1 if this big list does not contain the element.

Specified by:

indexOf in interface IntBigList

Overrides:

indexOf in class AbstractIntBigList

See Also:

BigList.indexOf(Object)

lastIndexOf

public long lastIndexOf(int k)

Description copied from interface: IntBigList

Returns the index of the last occurrence of the specified element in this type-specific big list, or -1 if this big list does not contain the element.

Specified by:

lastIndexOf in interface IntBigList

Overrides:

lastIndexOf in class AbstractIntBigList

See Also:

BigList.lastIndexOf(Object)

removeInt

public int removeInt(long index)

Description copied from class: AbstractIntBigList

Removes the element at the specified position.

This implementation always throws an UnsupportedOperationException.

Specified by:

removeInt in interface IntBigList

Overrides:

removeInt in class AbstractIntBigList

See Also:

BigList.remove(long)

set

public int set(long index,
               int k)

Description copied from class: AbstractIntBigList

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

This implementation always throws an UnsupportedOperationException.

Specified by:

set in interface IntBigList

Overrides:

set in class AbstractIntBigList

See Also:

BigList.set(long,Object)

isEmpty

public boolean isEmpty()

Description copied from interface: Stack

Checks whether the stack is empty.

Specified by:

isEmpty in interface Stack<java.lang.Integer>

Specified by:

isEmpty in interface java.util.Collection<java.lang.Integer>

Overrides:

isEmpty in class java.util.AbstractCollection<java.lang.Integer>

Returns:

true if the stack is empty.

toArray

public <T> T[] toArray(T[] a)

Specified by:

toArray in interface java.util.Collection<java.lang.Integer>

Overrides:

toArray in class java.util.AbstractCollection<java.lang.Integer>

containsAll

public boolean containsAll(java.util.Collection<?> c)

Specified by:

containsAll in interface java.util.Collection<java.lang.Integer>

Overrides:

containsAll in class java.util.AbstractCollection<java.lang.Integer>

addAll

public boolean addAll(java.util.Collection<? extends java.lang.Integer> c)

Description copied from class: AbstractIntBigList

This implementation delegates to the type-specific version of BigList.addAll(long, Collection).

Specified by:

addAll in interface java.util.Collection<java.lang.Integer>

Overrides:

addAll in class AbstractIntBigList

removeAll

public boolean removeAll(java.util.Collection<?> c)

Specified by:

removeAll in interface java.util.Collection<java.lang.Integer>

Overrides:

removeAll in class java.util.AbstractCollection<java.lang.Integer>

retainAll

public boolean retainAll(java.util.Collection<?> c)

Specified by:

retainAll in interface java.util.Collection<java.lang.Integer>

Overrides:

retainAll in class java.util.AbstractCollection<java.lang.Integer>

clear

public void clear()

Description copied from class: AbstractIntBigList

This implementation delegates to AbstractIntBigList.removeElements(long, long).

Specified by:

clear in interface java.util.Collection<java.lang.Integer>

Overrides:

clear in class AbstractIntBigList

hashCode

public int hashCode()

Description copied from class: AbstractIntBigList

Returns the hash code for this big list, which is identical to List.hashCode().

Specified by:

hashCode in interface java.util.Collection<java.lang.Integer>

Overrides:

hashCode in class AbstractIntBigList

Returns:

the hash code for this big list.