com.google.common.collect
Class PrimitiveArrays

java.lang.Object
  extended by com.google.common.collect.PrimitiveArrays

public final class PrimitiveArrays
extends Object

Static utility methods pertaining to arrays of Java primitives.

Author:
DJ Lee, Michael Parker, Jared Levy

Method Summary
static List<Boolean> asList(boolean[] backingArray)
          Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...).
static List<Byte> asList(byte[] backingArray)
          Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...).
static List<Character> asList(char[] backingArray)
          Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...).
static List<Double> asList(double[] backingArray)
          Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...).
static List<Float> asList(float[] backingArray)
          Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...).
static List<Integer> asList(int[] backingArray)
          Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...).
static List<Long> asList(long[] backingArray)
          Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...).
static List<Short> asList(short[] backingArray)
          Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...).
static boolean[] toBooleanArray(Collection<Boolean> collection)
          Converts a collection of Boolean instances into a new array of primitive booleans.
static byte[] toByteArray(Collection<Byte> collection)
          Converts a collection of Byte instances into a new array of primitive bytes.
static char[] toCharArray(Collection<Character> collection)
          Converts a collection of Character instances into a new array of primitive chars.
static double[] toDoubleArray(Collection<Double> collection)
          Converts a collection of Double instances into a new array of primitive doubles.
static float[] toFloatArray(Collection<Float> collection)
          Converts a collection of Float instances into a new array of primitive floats.
static int[] toIntArray(Collection<Integer> collection)
          Converts a collection of Integer instances into a new array of primitive ints.
static long[] toLongArray(Collection<Long> collection)
          Converts a collection of Long instances into a new array of primitive longs.
static short[] toShortArray(Collection<Short> collection)
          Converts a collection of Short instances into a new array of primitive shorts.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

toShortArray

public static short[] toShortArray(Collection<Short> collection)
Converts a collection of Short instances into a new array of primitive shorts.

Parameters:
collection - a collection of Short objects
Returns:
an array containing the same shorts as collection, in the same order, converted to primitives
Throws:
NullPointerException - if collection or any of its elements are null

asList

public static List<Short> asList(short[] backingArray)
Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...). The only additional restriction of the returned list is that null cannot be assigned to any element via List.set(int,Object) or ListIterator.set(E).

Parameters:
backingArray - the array to back the list
Returns:
a list view of the array

toIntArray

public static int[] toIntArray(Collection<Integer> collection)
Converts a collection of Integer instances into a new array of primitive ints.

Parameters:
collection - a collection of Integer objects
Returns:
an array containing the same ints as collection, in the same order, converted to primitives
Throws:
NullPointerException - if collection or any of its elements are null

asList

public static List<Integer> asList(int[] backingArray)
Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...). The only additional restriction of the returned list is that null cannot be assigned to any element via List.set(int,Object) or ListIterator.set(E).

Parameters:
backingArray - the array to back the list
Returns:
a list view of the array

toDoubleArray

public static double[] toDoubleArray(Collection<Double> collection)
Converts a collection of Double instances into a new array of primitive doubles.

Parameters:
collection - a collection of Double objects
Returns:
an array containing the same doubles as collection, in the same order, converted to primitives
Throws:
NullPointerException - if collection or any of its elements are null

asList

public static List<Double> asList(double[] backingArray)
Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...). The only additional restriction of the returned list is that null cannot be assigned to any element via List.set(int,Object) or ListIterator.set(E).

Parameters:
backingArray - the array to back the list
Returns:
a list view of the array

toFloatArray

public static float[] toFloatArray(Collection<Float> collection)
Converts a collection of Float instances into a new array of primitive floats.

Parameters:
collection - a collection of float objects
Returns:
an array containing the same floats as collection, in the same order, converted to primitives
Throws:
NullPointerException - if collection or any of its elements are null

asList

public static List<Float> asList(float[] backingArray)
Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...). The only additional restriction of the returned list is that null cannot be assigned to any element via List.set(int,Object) or ListIterator.set(E).

Parameters:
backingArray - the array to back the list
Returns:
a list view of the array

toLongArray

public static long[] toLongArray(Collection<Long> collection)
Converts a collection of Long instances into a new array of primitive longs.

Parameters:
collection - a collection of Long objects
Returns:
an array containing the same longs as collection, in the same order, converted to primitives
Throws:
NullPointerException - if collection or any of its elements are null

asList

public static List<Long> asList(long[] backingArray)
Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...). The only additional restriction of the returned list is that null cannot be assigned to any element via List.set(int,Object) or ListIterator.set(E).

Parameters:
backingArray - the array to back the list
Returns:
a list view of the array

toCharArray

public static char[] toCharArray(Collection<Character> collection)
Converts a collection of Character instances into a new array of primitive chars.

Parameters:
collection - a collection of Character objects
Returns:
an array containing the same chars as collection, in the same order, converted to primitives
Throws:
NullPointerException - if collection or any of its elements are null

asList

public static List<Character> asList(char[] backingArray)
Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...). The only additional restriction of the returned list is that null cannot be assigned to any element via List.set(int,Object) or ListIterator.set(E).

Parameters:
backingArray - the array to back the list
Returns:
a list view of the array

toBooleanArray

public static boolean[] toBooleanArray(Collection<Boolean> collection)
Converts a collection of Boolean instances into a new array of primitive booleans.

Parameters:
collection - a collection of Booleans objects
Returns:
an array containing the same booleans as collection, in the same order, converted to primitives
Throws:
NullPointerException - if collection or any of its elements are null

asList

public static List<Boolean> asList(boolean[] backingArray)
Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...). The only additional restriction of the returned list is that null cannot be assigned to any element via List.set(int,Object) or ListIterator.set(E).

Parameters:
backingArray - the array to back the list
Returns:
a list view of the array

toByteArray

public static byte[] toByteArray(Collection<Byte> collection)
Converts a collection of Byte instances into a new array of primitive bytes.

Parameters:
collection - a collection of Byte objects
Returns:
an array containing the same bytes as collection, in the same order, converted to primitives
Throws:
NullPointerException - if collection or any of its elements are null

asList

public static List<Byte> asList(byte[] backingArray)
Returns a fixed-size list backed by the specified array, similar to Arrays.asList(T...). The only additional restriction of the returned list is that null cannot be assigned to any element via List.set(int,Object) or ListIterator.set(E).

Parameters:
backingArray - the array to back the list
Returns:
a list view of the array