it.unimi.dsi.fastutil.longs
Interface LongBigList

All Superinterfaces:
BigList<java.lang.Long>, java.util.Collection<java.lang.Long>, java.lang.Comparable<BigList<? extends java.lang.Long>>, java.lang.Iterable<java.lang.Long>, LongCollection, LongIterable, Size64
All Known Implementing Classes:
AbstractLongBigList, AbstractLongBigList.LongSubList, LongBigArrayBigList, LongBigLists.EmptyBigList, LongBigLists.ListBigList, LongBigLists.Singleton, LongBigLists.SynchronizedBigList, LongBigLists.UnmodifiableBigList

public interface LongBigList
extends BigList<java.lang.Long>, LongCollection, java.lang.Comparable<BigList<? extends java.lang.Long>>

A type-specific BigList; provides some additional methods that use polymorphism to avoid (un)boxing.

Additionally, this interface strengthens iterator(), listIterator(), listIterator(long) and subList(long,long).

Besides polymorphic methods, this interfaces specifies methods to copy into an array or remove contiguous sublists. Although the abstract implementation of this interface provides simple, one-by-one implementations of these methods, it is expected that concrete implementation override them with optimized versions.

See Also:
List

Method Summary
 void add(long index, long key)
           
 boolean addAll(LongBigList c)
           
 boolean addAll(long index, LongBigList c)
           
 boolean addAll(long index, LongCollection c)
           
 void addElements(long index, long[][] a)
          Add (hopefully quickly) elements to this type-specific big list.
 void addElements(long index, long[][] a, long offset, long length)
          Add (hopefully quickly) elements to this type-specific big list.
 void getElements(long from, long[][] a, long offset, long length)
          Copies (hopefully quickly) elements of this type-specific big list into the given big array.
 long getLong(long index)
           
 long indexOf(long k)
           
 LongBigListIterator iterator()
          Returns a type-specific big-list iterator on this type-specific big list.
 long lastIndexOf(long k)
           
 LongBigListIterator listIterator()
          Returns a type-specific big-list iterator on this type-specific big list.
 LongBigListIterator listIterator(long index)
          Returns a type-specific list iterator on this type-specific big list starting at a given index.
 void removeElements(long from, long to)
          Removes (hopefully quickly) elements of this type-specific big list.
 long removeLong(long index)
           
 long set(long index, long k)
           
 LongBigList 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.
 
Methods inherited from interface it.unimi.dsi.fastutil.BigList
add, addAll, get, indexOf, lastIndexOf, remove, set, size
 
Methods inherited from interface it.unimi.dsi.fastutil.Size64
size, size64
 
Methods inherited from interface it.unimi.dsi.fastutil.longs.LongCollection
add, addAll, contains, containsAll, longIterator, rem, removeAll, retainAll, toArray, toArray, toLongArray, toLongArray
 
Methods inherited from interface java.util.Collection
add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, remove, removeAll, retainAll, size, toArray
 
Methods inherited from interface java.lang.Comparable
compareTo
 

Method Detail

iterator

LongBigListIterator iterator()
Returns a type-specific big-list iterator on this type-specific big list.

Specified by:
iterator in interface java.util.Collection<java.lang.Long>
Specified by:
iterator in interface java.lang.Iterable<java.lang.Long>
Specified by:
iterator in interface LongCollection
Specified by:
iterator in interface LongIterable
Returns:
a type-specific iterator on the elements of this collection.
See Also:
List.iterator()

listIterator

LongBigListIterator listIterator()
Returns a type-specific big-list iterator on this type-specific big list.

Specified by:
listIterator in interface BigList<java.lang.Long>
Returns:
a big-list iterator over the elements in this big list.
See Also:
List.listIterator()

listIterator

LongBigListIterator listIterator(long index)
Returns a type-specific list iterator on this type-specific big list starting at a given index.

Specified by:
listIterator in interface BigList<java.lang.Long>
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)

subList

LongBigList 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.

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

Specified by:
subList in interface BigList<java.lang.Long>
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)

getElements

void getElements(long from,
                 long[][] a,
                 long offset,
                 long length)
Copies (hopefully quickly) elements of this type-specific big list into the given big array.

Parameters:
from - the start index (inclusive).
a - the destination big array.
offset - the offset into the destination big array where to store the first element copied.
length - the number of elements to be copied.

removeElements

void removeElements(long from,
                    long to)
Removes (hopefully quickly) elements of this type-specific big list.

Parameters:
from - the start index (inclusive).
to - the end index (exclusive).

addElements

void addElements(long index,
                 long[][] a)
Add (hopefully quickly) elements to this type-specific big list.

Parameters:
index - the index at which to add elements.
a - the big array containing the elements.

addElements

void addElements(long index,
                 long[][] a,
                 long offset,
                 long length)
Add (hopefully quickly) elements to this type-specific big list.

Parameters:
index - the index at which to add elements.
a - the big array containing the elements.
offset - the offset of the first element to add.
length - the number of elements to add.

add

void add(long index,
         long key)
See Also:
List.add(int,Object)

addAll

boolean addAll(long index,
               LongCollection c)
See Also:
List.addAll(int,java.util.Collection)

addAll

boolean addAll(long index,
               LongBigList c)
See Also:
List.addAll(int,java.util.Collection)

addAll

boolean addAll(LongBigList c)
See Also:
List.addAll(int,java.util.Collection)

getLong

long getLong(long index)
See Also:
BigList.get(long)

indexOf

long indexOf(long k)
See Also:
BigList.indexOf(Object)

lastIndexOf

long lastIndexOf(long k)
See Also:
BigList.lastIndexOf(Object)

removeLong

long removeLong(long index)
See Also:
BigList.remove(long)

set

long set(long index,
         long k)
See Also:
BigList.set(long,Object)