it.unimi.dsi.fastutil.chars
Class CharBigLists.ListBigList

java.lang.Object
  extended by java.util.AbstractCollection<java.lang.Character>
      extended by it.unimi.dsi.fastutil.chars.AbstractCharCollection
          extended by it.unimi.dsi.fastutil.chars.AbstractCharBigList
              extended by it.unimi.dsi.fastutil.chars.CharBigLists.ListBigList
All Implemented Interfaces:
BigList<java.lang.Character>, CharBigList, CharCollection, CharIterable, CharStack, Size64, Stack<java.lang.Character>, java.io.Serializable, java.lang.Comparable<BigList<? extends java.lang.Character>>, java.lang.Iterable<java.lang.Character>, java.util.Collection<java.lang.Character>
Enclosing class:
CharBigLists

public static class CharBigLists.ListBigList
extends AbstractCharBigList
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.chars.AbstractCharBigList
AbstractCharBigList.CharSubList
 
Method Summary
 boolean add(char key)
           
 void add(long index, char key)
           
 boolean addAll(CharBigList c)
           
 boolean addAll(CharCollection c)
          Adds all elements of the given type-specific collection to this collection.
 boolean addAll(java.util.Collection<? extends java.lang.Character> c)
          Delegates to a more generic method.
 boolean addAll(long index, CharBigList c)
          Delegates to a more generic method.
 boolean addAll(long index, CharCollection c)
          Delegates to a more generic method.
 boolean addAll(long index, java.util.Collection<? extends java.lang.Character> c)
          Inserts all of the elements in the specified collection into this big list at the specified position (optional operation).
 void clear()
           
 boolean contains(char key)
           
 boolean containsAll(CharCollection c)
          Checks whether this collection contains all elements from the given type-specific collection.
 boolean containsAll(java.util.Collection<?> c)
          Checks whether this collection contains all elements from the given collection.
 char getChar(long index)
           
 int hashCode()
          Returns the hash code for this big list, which is identical to List.hashCode().
 long indexOf(char k)
           
 boolean isEmpty()
          Checks whether the stack is empty.
 CharBigListIterator iterator()
          Returns a type-specific iterator on the elements of this collection.
 long lastIndexOf(char k)
           
 CharBigListIterator listIterator()
          Returns a type-specific big-list iterator on this type-specific big list.
 CharBigListIterator listIterator(long index)
          Returns a type-specific list iterator on this type-specific big list starting at a given index.
 boolean removeAll(CharCollection c)
          Remove from this collection all elements in the given type-specific collection.
 boolean removeAll(java.util.Collection<?> c)
          Remove from this collection all elements in the given collection.
 char removeChar(long index)
           
 void removeElements(long from, long to)
          Removes elements of this type-specific big list one-by-one.
 boolean retainAll(CharCollection c)
          Retains in this collection only elements from the given type-specific collection.
 boolean retainAll(java.util.Collection<?> c)
          Retains in this collection only elements from the given collection.
 char set(long index, char k)
           
 int size()
          Deprecated. 
 void size(long size)
          Sets the size of this big list.
 long size64()
          Returns the size of this data structure as a long.
 CharBigList 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)
          Returns an containing the items of this collection; the runtime type of the returned array is that of the specified array.
 char[] toCharArray()
          Returns a primitive type array containing the items of this collection.
 char[] toCharArray(char[] a)
          Returns a primitive type array containing the items of this collection.
 
Methods inherited from class it.unimi.dsi.fastutil.chars.AbstractCharBigList
add, addAll, addElements, addElements, compareTo, equals, get, getChar, getElements, indexOf, lastIndexOf, listIterator, peek, peekChar, pop, popChar, push, push, rem, remove, remove, removeChar, set, set, size, top, topChar, toString
 
Methods inherited from class it.unimi.dsi.fastutil.chars.AbstractCharCollection
add, charIterator, contains, rem, remove, toArray, toArray
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface it.unimi.dsi.fastutil.chars.CharCollection
charIterator, toArray
 
Methods inherited from interface java.util.Collection
add, contains, remove, toArray
 

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

@Deprecated
public int size()
Deprecated. 

Description copied from interface: Size64
Returns the size of this data structure, minimized with Integer.MAX_VALUE.

Specified by:
size in interface Size64
Specified by:
size in interface java.util.Collection<java.lang.Character>
Overrides:
size in class AbstractCharBigList
Returns:
the size of this data structure, minimized with Integer.MAX_VALUE.
See Also:
Collection.size()

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.Character>
Overrides:
size in class AbstractCharBigList
Parameters:
size - the new size.

iterator

public CharBigListIterator iterator()
Description copied from interface: CharCollection
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.

Specified by:
iterator in interface CharBigList
Specified by:
iterator in interface CharCollection
Specified by:
iterator in interface CharIterable
Specified by:
iterator in interface java.lang.Iterable<java.lang.Character>
Specified by:
iterator in interface java.util.Collection<java.lang.Character>
Overrides:
iterator in class AbstractCharBigList
Returns:
a type-specific iterator on the elements of this collection.
See Also:
List.iterator()

listIterator

public CharBigListIterator listIterator()
Description copied from interface: CharBigList
Returns a type-specific big-list iterator on this type-specific big list.

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

addAll

public boolean addAll(long index,
                      java.util.Collection<? extends java.lang.Character> c)
Description copied from interface: BigList
Inserts all of the elements in the specified collection into this big list at the specified position (optional operation).

Specified by:
addAll in interface BigList<java.lang.Character>
Overrides:
addAll in class AbstractCharBigList
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)

listIterator

public CharBigListIterator listIterator(long index)
Description copied from interface: CharBigList
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.Character>
Specified by:
listIterator in interface CharBigList
Overrides:
listIterator in class AbstractCharBigList
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

public CharBigList subList(long from,
                           long to)
Description copied from interface: CharBigList
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.Character>
Specified by:
subList in interface CharBigList
Overrides:
subList in class AbstractCharBigList
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(char key)
Specified by:
contains in interface CharCollection
Overrides:
contains in class AbstractCharBigList
See Also:
Collection.contains(Object)

toCharArray

public char[] toCharArray()
Description copied from interface: CharCollection
Returns a primitive type array containing the items of this collection.

Specified by:
toCharArray in interface CharCollection
Overrides:
toCharArray in class AbstractCharCollection
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: AbstractCharBigList
Removes elements of this type-specific big list one-by-one.

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 CharBigList
Overrides:
removeElements in class AbstractCharBigList
Parameters:
from - the start index (inclusive).
to - the end index (exclusive).

toCharArray

public char[] toCharArray(char[] a)
Description copied from interface: CharCollection
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:
toCharArray in interface CharCollection
Overrides:
toCharArray in class AbstractCharCollection
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[])

add

public void add(long index,
                char key)
Specified by:
add in interface CharBigList
Overrides:
add in class AbstractCharBigList
See Also:
List.add(int,Object)

addAll

public boolean addAll(long index,
                      CharCollection c)
Description copied from class: AbstractCharBigList
Delegates to a more generic method.

Specified by:
addAll in interface CharBigList
Overrides:
addAll in class AbstractCharBigList
See Also:
List.addAll(int,java.util.Collection)

addAll

public boolean addAll(long index,
                      CharBigList c)
Description copied from class: AbstractCharBigList
Delegates to a more generic method.

Specified by:
addAll in interface CharBigList
Overrides:
addAll in class AbstractCharBigList
See Also:
List.addAll(int,java.util.Collection)

add

public boolean add(char key)
Specified by:
add in interface CharCollection
Overrides:
add in class AbstractCharBigList
See Also:
Collection.add(Object)

addAll

public boolean addAll(CharBigList c)
Specified by:
addAll in interface CharBigList
Overrides:
addAll in class AbstractCharBigList
See Also:
List.addAll(int,java.util.Collection)

getChar

public char getChar(long index)
Specified by:
getChar in interface CharBigList
See Also:
BigList.get(long)

indexOf

public long indexOf(char k)
Specified by:
indexOf in interface CharBigList
Overrides:
indexOf in class AbstractCharBigList
See Also:
BigList.indexOf(Object)

lastIndexOf

public long lastIndexOf(char k)
Specified by:
lastIndexOf in interface CharBigList
Overrides:
lastIndexOf in class AbstractCharBigList
See Also:
BigList.lastIndexOf(Object)

removeChar

public char removeChar(long index)
Specified by:
removeChar in interface CharBigList
Overrides:
removeChar in class AbstractCharBigList
See Also:
BigList.remove(long)

set

public char set(long index,
                char k)
Specified by:
set in interface CharBigList
Overrides:
set in class AbstractCharBigList
See Also:
BigList.set(long,Object)

addAll

public boolean addAll(CharCollection c)
Description copied from class: AbstractCharCollection
Adds all elements of the given type-specific collection to this collection.

Specified by:
addAll in interface CharCollection
Overrides:
addAll in class AbstractCharBigList
Parameters:
c - a type-specific collection.
Returns:
true if this collection changed as a result of the call.
See Also:
Collection.addAll(Collection)

containsAll

public boolean containsAll(CharCollection c)
Description copied from class: AbstractCharCollection
Checks whether this collection contains all elements from the given type-specific collection.

Specified by:
containsAll in interface CharCollection
Overrides:
containsAll in class AbstractCharCollection
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(CharCollection c)
Description copied from class: AbstractCharCollection
Remove from this collection all elements in the given type-specific collection.

Specified by:
removeAll in interface CharCollection
Overrides:
removeAll in class AbstractCharCollection
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(CharCollection c)
Description copied from class: AbstractCharCollection
Retains in this collection only elements from the given type-specific collection.

Specified by:
retainAll in interface CharCollection
Overrides:
retainAll in class AbstractCharCollection
Parameters:
c - a type-specific collection.
Returns:
true if this collection changed as a result of the call.
See Also:
Collection.retainAll(Collection)

isEmpty

public boolean isEmpty()
Description copied from interface: Stack
Checks whether the stack is empty.

Specified by:
isEmpty in interface Stack<java.lang.Character>
Specified by:
isEmpty in interface java.util.Collection<java.lang.Character>
Overrides:
isEmpty in class AbstractCharCollection
Returns:
true if the stack is empty.

toArray

public <T> T[] toArray(T[] a)
Description copied from interface: CharCollection
Returns an containing the items of this collection; the runtime type of the returned array is that of the specified array.

Warning: 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:
toArray in interface CharCollection
Specified by:
toArray in interface java.util.Collection<java.lang.Character>
Overrides:
toArray in class AbstractCharCollection
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[])

containsAll

public boolean containsAll(java.util.Collection<?> c)
Description copied from class: AbstractCharCollection
Checks whether this collection contains all elements from the given collection.

Specified by:
containsAll in interface java.util.Collection<java.lang.Character>
Overrides:
containsAll in class AbstractCharCollection
Parameters:
c - a collection.
Returns:
true if this collection contains all elements of the argument.

addAll

public boolean addAll(java.util.Collection<? extends java.lang.Character> c)
Description copied from class: AbstractCharBigList
Delegates to a more generic method.

Specified by:
addAll in interface java.util.Collection<java.lang.Character>
Overrides:
addAll in class AbstractCharBigList
Parameters:
c - a collection.
Returns:
true if this collection changed as a result of the call.

removeAll

public boolean removeAll(java.util.Collection<?> c)
Description copied from class: AbstractCharCollection
Remove from this collection all elements in the given collection. If the collection is an instance of this class, it uses faster iterators.

Specified by:
removeAll in interface java.util.Collection<java.lang.Character>
Overrides:
removeAll in class AbstractCharCollection
Parameters:
c - a collection.
Returns:
true if this collection changed as a result of the call.

retainAll

public boolean retainAll(java.util.Collection<?> c)
Description copied from class: AbstractCharCollection
Retains in this collection only elements from the given collection.

Specified by:
retainAll in interface java.util.Collection<java.lang.Character>
Overrides:
retainAll in class AbstractCharCollection
Parameters:
c - a collection.
Returns:
true if this collection changed as a result of the call.

clear

public void clear()
Specified by:
clear in interface java.util.Collection<java.lang.Character>
Overrides:
clear in class java.util.AbstractCollection<java.lang.Character>

hashCode

public int hashCode()
Description copied from class: AbstractCharBigList
Returns the hash code for this big list, which is identical to List.hashCode().

Specified by:
hashCode in interface java.util.Collection<java.lang.Character>
Overrides:
hashCode in class AbstractCharBigList
Returns:
the hash code for this big list.