it.unimi.dsi.fastutil.ints
Class IntLists

java.lang.Object
  extended by it.unimi.dsi.fastutil.ints.IntLists

public class IntLists
extends Object

A class providing static methods and objects that do useful things with type-specific lists.

See Also:
Collections

Nested Class Summary
static class IntLists.EmptyList
          An immutable class representing an empty type-specific list.
static class IntLists.Singleton
          An immutable class representing a type-specific singleton list.
static class IntLists.SynchronizedList
          A synchronized wrapper class for lists.
static class IntLists.UnmodifiableList
          An unmodifiable wrapper class for lists.
 
Field Summary
static IntLists.EmptyList EMPTY_LIST
          An empty list (immutable).
 
Method Summary
static IntList shuffle(IntList l, Random random)
          Shuffles the specified list using the specified pseudorandom number generator.
static IntList singleton(int element)
          Returns a type-specific immutable list containing only the specified element.
static IntList singleton(Object element)
          Returns a type-specific immutable list containing only the specified element.
static IntList synchronize(IntList l)
          Returns a synchronized type-specific list backed by the given type-specific list.
static IntList synchronize(IntList l, Object sync)
          Returns a synchronized type-specific list backed by the given type-specific list, using an assigned object to synchronize.
static IntList unmodifiable(IntList l)
          Returns an unmodifiable type-specific list backed by the given type-specific list.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

EMPTY_LIST

public static final IntLists.EmptyList EMPTY_LIST
An empty list (immutable). It is serializable and cloneable.

The class of this objects represent an abstract empty list that is a sublist of any type of list. Thus, EMPTY_LIST may be assigned to a variable of any (sorted) type-specific list.

Method Detail

shuffle

public static IntList shuffle(IntList l,
                              Random random)
Shuffles the specified list using the specified pseudorandom number generator.

Parameters:
l - the list to be shuffled.
random - a pseudorandom number generator (please use a XorShift* generator).
Returns:
l.

singleton

public static IntList singleton(int element)
Returns a type-specific immutable list containing only the specified element. The returned list is serializable and cloneable.

Parameters:
element - the only element of the returned list.
Returns:
a type-specific immutable list containing just element.

singleton

public static IntList singleton(Object element)
Returns a type-specific immutable list containing only the specified element. The returned list is serializable and cloneable.

Parameters:
element - the only element of the returned list.
Returns:
a type-specific immutable list containing just element.

synchronize

public static IntList synchronize(IntList l)
Returns a synchronized type-specific list backed by the given type-specific list.

Parameters:
l - the list to be wrapped in a synchronized list.
Returns:
a synchronized view of the specified list.
See Also:
Collections.synchronizedList(List)

synchronize

public static IntList synchronize(IntList l,
                                  Object sync)
Returns a synchronized type-specific list backed by the given type-specific list, using an assigned object to synchronize.

Parameters:
l - the list to be wrapped in a synchronized list.
sync - an object that will be used to synchronize the access to the list.
Returns:
a synchronized view of the specified list.
See Also:
Collections.synchronizedList(List)

unmodifiable

public static IntList unmodifiable(IntList l)
Returns an unmodifiable type-specific list backed by the given type-specific list.

Parameters:
l - the list to be wrapped in an unmodifiable list.
Returns:
an unmodifiable view of the specified list.
See Also:
Collections.unmodifiableList(List)