Interface IntList

    • Method Summary

      All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods 
      Modifier and Type Method Description
      boolean add​(int key)
      Appends the specified element to the end of this list (optional operation).
      void add​(int index, int key)
      Inserts the specified element at the specified position in this list (optional operation).
      default void add​(int index, java.lang.Integer key)
      Deprecated.
      Please use the corresponding type-specific method instead.
      default boolean add​(java.lang.Integer k)
      Deprecated.
      Please use the corresponding type-specific method instead.
      boolean addAll​(int index, IntCollection c)
      Inserts all of the elements in the specified type-specific collection into this type-specific list at the specified position (optional operation).
      boolean addAll​(int index, IntList c)
      Inserts all of the elements in the specified type-specific list into this type-specific list at the specified position (optional operation).
      boolean addAll​(IntList c)
      Appends all of the elements in the specified type-specific list to the end of this type-specific list (optional operation).
      void addElements​(int index, int[] a)
      Add (hopefully quickly) elements to this type-specific list.
      void addElements​(int index, int[] a, int offset, int length)
      Add (hopefully quickly) elements to this type-specific list.
      default boolean contains​(java.lang.Object key)
      Deprecated.
      Please use the corresponding type-specific method instead.
      default java.lang.Integer get​(int index)
      Deprecated.
      Please use the corresponding type-specific method instead.
      void getElements​(int from, int[] a, int offset, int length)
      Copies (hopefully quickly) elements of this type-specific list into the given array.
      int getInt​(int index)
      Returns the element at the specified position in this list.
      int indexOf​(int k)
      Returns the index of the first occurrence of the specified element in this list, or -1 if this list does not contain the element.
      default int indexOf​(java.lang.Object o)
      Deprecated.
      Please use the corresponding type-specific method instead.
      IntListIterator iterator()
      Returns a type-specific iterator on the elements of this list.
      int lastIndexOf​(int k)
      Returns the index of the last occurrence of the specified element in this list, or -1 if this list does not contain the element.
      default int lastIndexOf​(java.lang.Object o)
      Deprecated.
      Please use the corresponding type-specific method instead.
      IntListIterator listIterator()
      Returns a type-specific list iterator on the list.
      IntListIterator listIterator​(int index)
      Returns a type-specific list iterator on the list starting at a given index.
      default java.lang.Integer remove​(int index)
      Deprecated.
      Please use the corresponding type-specific method instead.
      default boolean remove​(java.lang.Object key)
      Deprecated.
      Please use the corresponding type-specific method instead.
      void removeElements​(int from, int to)
      Removes (hopefully quickly) elements of this type-specific list.
      int removeInt​(int index)
      Removes the element at the specified position in this list (optional operation).
      int set​(int index, int k)
      Replaces the element at the specified position in this list with the specified element (optional operation).
      default java.lang.Integer set​(int index, java.lang.Integer k)
      Deprecated.
      Please use the corresponding type-specific method instead.
      default void setElements​(int[] a)
      Set (hopefully quickly) elements to match the array given.
      default void setElements​(int index, int[] a)
      Set (hopefully quickly) elements to match the array given.
      default void setElements​(int index, int[] a, int offset, int length)
      Set (hopefully quickly) elements to match the array given.
      void size​(int size)
      Sets the size of this list.
      default void sort​(IntComparator comparator)
      Sort a list using a type-specific comparator.
      default void sort​(java.util.Comparator<? super java.lang.Integer> comparator)
      Deprecated.
      Please use the corresponding type-specific method instead.
      IntList subList​(int from, int to)
      Returns a type-specific view of the portion of this list from the index from, inclusive, to the index to, exclusive.
      default void unstableSort​(IntComparator comparator)
      Sorts this list using a sort not assured to be stable.
      default void unstableSort​(java.util.Comparator<? super java.lang.Integer> comparator)
      Deprecated.
      Please use the corresponding type-specific method instead.
      • Methods inherited from interface java.util.Collection

        parallelStream, stream, toArray
      • Methods inherited from interface java.lang.Comparable

        compareTo
      • Methods inherited from interface java.util.List

        addAll, addAll, clear, containsAll, equals, hashCode, isEmpty, removeAll, replaceAll, retainAll, size, spliterator, toArray, toArray
    • Method Detail

      • iterator

        IntListIterator iterator()
        Returns a type-specific iterator on the elements of this list.

        Note that this specification strengthens the one given in List.iterator(). It would not be normally necessary, but Iterable.iterator() is bizarrily re-specified in List.

        Specified by:
        iterator in interface java.util.Collection<java.lang.Integer>
        Specified by:
        iterator in interface IntCollection
        Specified by:
        iterator in interface IntIterable
        Specified by:
        iterator in interface java.lang.Iterable<java.lang.Integer>
        Specified by:
        iterator in interface java.util.List<java.lang.Integer>
        Returns:
        an iterator on the elements of this list.
        See Also:
        Iterable.iterator()
      • listIterator

        IntListIterator listIterator()
        Returns a type-specific list iterator on the list.
        Specified by:
        listIterator in interface java.util.List<java.lang.Integer>
        See Also:
        List.listIterator()
      • listIterator

        IntListIterator listIterator​(int index)
        Returns a type-specific list iterator on the list starting at a given index.
        Specified by:
        listIterator in interface java.util.List<java.lang.Integer>
        See Also:
        List.listIterator(int)
      • subList

        IntList subList​(int from,
                        int to)
        Returns a type-specific view of the portion of this list from the index from, inclusive, to the index to, exclusive.

        Note that this specification strengthens the one given in List.subList(int,int).

        Specified by:
        subList in interface java.util.List<java.lang.Integer>
        See Also:
        List.subList(int,int)
      • size

        void size​(int size)
        Sets the size of this list.

        If the specified size is smaller than the current size, the last elements are discarded. Otherwise, they are filled with 0/null/false.

        Parameters:
        size - the new size.
      • getElements

        void getElements​(int from,
                         int[] a,
                         int offset,
                         int length)
        Copies (hopefully quickly) elements of this type-specific list into the given array.
        Parameters:
        from - the start index (inclusive).
        a - the destination array.
        offset - the offset into the destination array where to store the first element copied.
        length - the number of elements to be copied.
      • removeElements

        void removeElements​(int from,
                            int to)
        Removes (hopefully quickly) elements of this type-specific list.
        Parameters:
        from - the start index (inclusive).
        to - the end index (exclusive).
      • addElements

        void addElements​(int index,
                         int[] a)
        Add (hopefully quickly) elements to this type-specific list.
        Parameters:
        index - the index at which to add elements.
        a - the array containing the elements.
      • addElements

        void addElements​(int index,
                         int[] a,
                         int offset,
                         int length)
        Add (hopefully quickly) elements to this type-specific list.
        Parameters:
        index - the index at which to add elements.
        a - the array containing the elements.
        offset - the offset of the first element to add.
        length - the number of elements to add.
      • setElements

        default void setElements​(int[] a)
        Set (hopefully quickly) elements to match the array given.
        Parameters:
        a - the array containing the elements.
        Since:
        8.3.0
      • setElements

        default void setElements​(int index,
                                 int[] a)
        Set (hopefully quickly) elements to match the array given.
        Parameters:
        index - the index at which to start setting elements.
        a - the array containing the elements.
        Since:
        8.3.0
      • setElements

        default void setElements​(int index,
                                 int[] a,
                                 int offset,
                                 int length)
        Set (hopefully quickly) elements to match the array given. Sets each in this list to the corresponding elements in the array, as if by
        
         ListIterator iter = listIterator(index);
         int i = 0;
         while (i < length) {
           iter.next();
           iter.set(a[offset + i++]);
         }
         
        However, the exact implementation may be more efficient, taking into account whether random access is faster or not, or at the discretion of subclasses, abuse internals.
        Parameters:
        index - the index at which to start setting elements.
        a - the array containing the elements
        offset - the offset of the first element to add.
        length - the number of elements to add.
        Since:
        8.3.0
      • add

        boolean add​(int key)
        Appends the specified element to the end of this list (optional operation).
        Specified by:
        add in interface IntCollection
        See Also:
        List.add(Object)
      • add

        void add​(int index,
                 int key)
        Inserts the specified element at the specified position in this list (optional operation).
        See Also:
        List.add(int,Object)
      • add

        @Deprecated
        default void add​(int index,
                         java.lang.Integer key)
        Deprecated.
        Please use the corresponding type-specific method instead.
        Specified by:
        add in interface java.util.List<java.lang.Integer>
      • addAll

        boolean addAll​(int index,
                       IntCollection c)
        Inserts all of the elements in the specified type-specific collection into this type-specific list at the specified position (optional operation).
        See Also:
        List.addAll(int,java.util.Collection)
      • addAll

        boolean addAll​(int index,
                       IntList c)
        Inserts all of the elements in the specified type-specific list into this type-specific list at the specified position (optional operation).
        See Also:
        List.add(int,Object)
      • addAll

        boolean addAll​(IntList c)
        Appends all of the elements in the specified type-specific list to the end of this type-specific list (optional operation).
        See Also:
        List.add(int,Object)
      • set

        int set​(int index,
                int k)
        Replaces the element at the specified position in this list with the specified element (optional operation).
        See Also:
        List.set(int,Object)
      • getInt

        int getInt​(int index)
        Returns the element at the specified position in this list.
        See Also:
        List.get(int)
      • indexOf

        int indexOf​(int k)
        Returns the index of the first occurrence of the specified element in this list, or -1 if this list does not contain the element.
        See Also:
        List.indexOf(Object)
      • lastIndexOf

        int lastIndexOf​(int k)
        Returns the index of the last occurrence of the specified element in this list, or -1 if this list does not contain the element.
        See Also:
        List.lastIndexOf(Object)
      • contains

        @Deprecated
        default boolean contains​(java.lang.Object key)
        Deprecated.
        Please use the corresponding type-specific method instead.
        Specified by:
        contains in interface java.util.Collection<java.lang.Integer>
        Specified by:
        contains in interface IntCollection
        Specified by:
        contains in interface java.util.List<java.lang.Integer>
      • get

        @Deprecated
        default java.lang.Integer get​(int index)
        Deprecated.
        Please use the corresponding type-specific method instead.
        Specified by:
        get in interface java.util.List<java.lang.Integer>
      • indexOf

        @Deprecated
        default int indexOf​(java.lang.Object o)
        Deprecated.
        Please use the corresponding type-specific method instead.
        Specified by:
        indexOf in interface java.util.List<java.lang.Integer>
      • lastIndexOf

        @Deprecated
        default int lastIndexOf​(java.lang.Object o)
        Deprecated.
        Please use the corresponding type-specific method instead.
        Specified by:
        lastIndexOf in interface java.util.List<java.lang.Integer>
      • add

        @Deprecated
        default boolean add​(java.lang.Integer k)
        Deprecated.
        Please use the corresponding type-specific method instead.

        This method specification is a workaround for bug 8177440.

        Specified by:
        add in interface java.util.Collection<java.lang.Integer>
        Specified by:
        add in interface IntCollection
        Specified by:
        add in interface java.util.List<java.lang.Integer>
      • removeInt

        int removeInt​(int index)
        Removes the element at the specified position in this list (optional operation).
        See Also:
        List.remove(int)
      • remove

        @Deprecated
        default boolean remove​(java.lang.Object key)
        Deprecated.
        Please use the corresponding type-specific method instead.
        Specified by:
        remove in interface java.util.Collection<java.lang.Integer>
        Specified by:
        remove in interface IntCollection
        Specified by:
        remove in interface java.util.List<java.lang.Integer>
      • remove

        @Deprecated
        default java.lang.Integer remove​(int index)
        Deprecated.
        Please use the corresponding type-specific method instead.
        Specified by:
        remove in interface java.util.List<java.lang.Integer>
      • set

        @Deprecated
        default java.lang.Integer set​(int index,
                                      java.lang.Integer k)
        Deprecated.
        Please use the corresponding type-specific method instead.
        Specified by:
        set in interface java.util.List<java.lang.Integer>
      • sort

        @Deprecated
        default void sort​(java.util.Comparator<? super java.lang.Integer> comparator)
        Deprecated.
        Please use the corresponding type-specific method instead.
        Specified by:
        sort in interface java.util.List<java.lang.Integer>
      • sort

        default void sort​(IntComparator comparator)
        Sort a list using a type-specific comparator.

        Pass null to sort using natural ordering.

        Since:
        8.3.0
        See Also:
        List.sort(java.util.Comparator)
      • unstableSort

        @Deprecated
        default void unstableSort​(java.util.Comparator<? super java.lang.Integer> comparator)
        Deprecated.
        Please use the corresponding type-specific method instead.
        Sorts this list using a sort not assured to be stable.
      • unstableSort

        default void unstableSort​(IntComparator comparator)
        Sorts this list using a sort not assured to be stable.

        Pass null to sort using natural ordering.

        This differs from List.sort(java.util.Comparator) in that the results are not assured to be stable, but may be a bit faster.

        Unless a subclass specifies otherwise, the results of the method if the list is concurrently modified during the sort are unspecified.

        Since:
        8.3.0