Class Lists


  • public final class Lists
    extends java.lang.Object
    Static utility methods pertaining to List instances.

    NOTE: this is a copy of a subset of Guava's Lists. The implementation must match as closely as possible to Guava's implementation.

    Since:
    1.14
    • Constructor Summary

      Constructors 
      Modifier Constructor Description
      private Lists()  
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static <E> java.util.ArrayList<E> newArrayList()
      Returns a new mutable, empty ArrayList instance.
      static <E> java.util.ArrayList<E> newArrayList​(java.lang.Iterable<? extends E> elements)
      Returns a new mutable ArrayList instance containing the given elements.
      static <E> java.util.ArrayList<E> newArrayList​(java.util.Iterator<? extends E> elements)
      Returns a new mutable ArrayList instance containing the given elements.
      static <E> java.util.ArrayList<E> newArrayListWithCapacity​(int initialArraySize)
      Creates an ArrayList instance backed by an array of the exact size specified; equivalent to ArrayList(int).
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • Lists

        private Lists()
    • Method Detail

      • newArrayList

        public static <E> java.util.ArrayList<E> newArrayList()
        Returns a new mutable, empty ArrayList instance.
      • newArrayListWithCapacity

        public static <E> java.util.ArrayList<E> newArrayListWithCapacity​(int initialArraySize)
        Creates an ArrayList instance backed by an array of the exact size specified; equivalent to ArrayList(int).
        Parameters:
        initialArraySize - the exact size of the initial backing array for the returned array list (ArrayList documentation calls this value the "capacity")
        Returns:
        a new, empty ArrayList which is guaranteed not to resize itself unless its size reaches initialArraySize + 1
        Throws:
        java.lang.IllegalArgumentException - if initialArraySize is negative
      • newArrayList

        public static <E> java.util.ArrayList<E> newArrayList​(java.lang.Iterable<? extends E> elements)
        Returns a new mutable ArrayList instance containing the given elements.
        Parameters:
        elements - the elements that the list should contain, in order
        Returns:
        a new ArrayList containing those elements
      • newArrayList

        public static <E> java.util.ArrayList<E> newArrayList​(java.util.Iterator<? extends E> elements)
        Returns a new mutable ArrayList instance containing the given elements.
        Parameters:
        elements - the elements that the list should contain, in order
        Returns:
        a new ArrayList containing those elements