Class AbstractLongCollection

    • Method Summary

      All Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      boolean add​(long k)
      Ensures that this collection contains the specified element (optional operation).
      boolean add​(java.lang.Long key)
      Deprecated.
      Please use the corresponding type-specific method instead.
      boolean addAll​(LongCollection c)
      Adds all elements of the given type-specific collection to this collection.
      boolean addAll​(java.util.Collection<? extends java.lang.Long> c)
      boolean contains​(long k)
      Returns true if this collection contains the specified element.
      boolean contains​(java.lang.Object key)
      Deprecated.
      Please use the corresponding type-specific method instead.
      boolean containsAll​(LongCollection c)
      Checks whether this collection contains all elements from the given type-specific collection.
      boolean containsAll​(java.util.Collection<?> c)
      void forEach​(LongConsumer action)
      Performs the given action for each element of this type-specific Iterable until all elements have been processed or the action throws an exception.
      abstract LongIterator iterator()
      Returns a type-specific iterator on the elements of this collection.
      boolean rem​(long k)
      Removes a single instance of the specified element from this collection, if it is present (optional operation).
      boolean remove​(java.lang.Object key)
      Deprecated.
      Please use the corresponding type-specific method instead.
      boolean removeAll​(LongCollection c)
      Remove from this collection all elements in the given type-specific collection.
      boolean removeAll​(java.util.Collection<?> c)
      boolean removeIf​(LongPredicate filter)
      Remove from this collection all elements which satisfy the given predicate.
      boolean retainAll​(LongCollection c)
      Retains in this collection only elements from the given type-specific collection.
      boolean retainAll​(java.util.Collection<?> c)
      long[] toArray​(long[] a)
      Returns an array containing all of the elements in this collection; the runtime type of the returned array is that of the specified array.
      long[] toLongArray()
      Returns a primitive type array containing the items of this collection.
      long[] toLongArray​(long[] a)
      Deprecated.
      Please use toArray() instead—this method is redundant and will be removed in the future.
      java.lang.String toString()  
      • Methods inherited from class java.util.AbstractCollection

        clear, isEmpty, size, toArray, toArray
      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
      • Methods inherited from interface java.util.Collection

        clear, equals, hashCode, isEmpty, size, toArray, toArray, toArray
    • Method Detail

      • iterator

        public abstract LongIterator iterator()
        Description copied from interface: LongCollection
        Returns a type-specific iterator on the elements of this collection.
        Specified by:
        iterator in interface java.util.Collection<java.lang.Long>
        Specified by:
        iterator in interface java.lang.Iterable<java.lang.Long>
        Specified by:
        iterator in interface LongCollection
        Specified by:
        iterator in interface LongIterable
        Specified by:
        iterator in class java.util.AbstractCollection<java.lang.Long>
        Returns:
        a type-specific iterator on the elements of this collection.
        See Also:
        Iterable.iterator()
      • add

        public boolean add​(long k)
        Ensures that this collection contains the specified element (optional operation).
        Specified by:
        add in interface LongCollection
        See Also:
        Collection.add(Object)
        Implementation Specification:
        This implementation always throws an UnsupportedOperationException.
      • contains

        public boolean contains​(long k)
        Returns true if this collection contains the specified element.
        Specified by:
        contains in interface LongCollection
        See Also:
        Collection.contains(Object)
        Implementation Specification:
        This implementation iterates over the elements in the collection, looking for the specified element.
      • rem

        public boolean rem​(long k)
        Removes a single instance of the specified element from this collection, if it is present (optional operation).

        Note that this method should be called remove(), but the clash with the similarly named index-based method in the List interface forces us to use a distinguished name. For simplicity, the set interfaces reinstates remove().

        Specified by:
        rem in interface LongCollection
        See Also:
        Collection.remove(Object)
        Implementation Specification:
        This implementation iterates over the elements in the collection, looking for the specified element and tries to remove it.
      • add

        @Deprecated
        public boolean add​(java.lang.Long key)
        Deprecated.
        Please use the corresponding type-specific method instead.
        Specified by:
        add in interface java.util.Collection<java.lang.Long>
        Specified by:
        add in interface LongCollection
        Overrides:
        add in class java.util.AbstractCollection<java.lang.Long>
      • contains

        @Deprecated
        public 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.Long>
        Specified by:
        contains in interface LongCollection
        Overrides:
        contains in class java.util.AbstractCollection<java.lang.Long>
      • remove

        @Deprecated
        public 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.Long>
        Specified by:
        remove in interface LongCollection
        Overrides:
        remove in class java.util.AbstractCollection<java.lang.Long>
      • toArray

        public long[] toArray​(long[] a)
        Description copied from interface: LongCollection
        Returns an array containing all of the elements in this collection; the runtime type of the returned array is that of the specified array.

        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 LongCollection
        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[])
      • toLongArray

        public long[] toLongArray()
        Description copied from interface: LongCollection
        Returns a primitive type array containing the items of this collection.
        Specified by:
        toLongArray in interface LongCollection
        Returns:
        a primitive type array containing the items of this collection.
        See Also:
        Collection.toArray()
      • toLongArray

        @Deprecated
        public long[] toLongArray​(long[] a)
        Deprecated.
        Please use toArray() instead—this method is redundant and will be removed in the future.
        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:
        toLongArray in interface LongCollection
        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[])
      • forEach

        public final void forEach​(LongConsumer action)
        Performs the given action for each element of this type-specific Iterable until all elements have been processed or the action throws an exception.

        WARNING: Overriding this method is almost always a mistake, as this overload only exists to disambiguate. Instead, override the forEach() overload that uses the JDK's primitive consumer type (e.g. IntConsumer).

        If Java supported final default methods, this would be one, but sadly it does not.

        If you checked and are overriding the version with java.util.function.XConsumer, and still see this warning, then your IDE is incorrectly conflating this method with the proper method to override, and you can safely ignore this message.

        Specified by:
        forEach in interface LongIterable
        Parameters:
        action - the action to be performed for each element.
        See Also:
        Iterable.forEach(java.util.function.Consumer)
        API Notes:
        This method exists to make final what should have been final in the interface.
      • removeIf

        public final boolean removeIf​(LongPredicate filter)
        Remove from this collection all elements which satisfy the given predicate.

        WARNING: Overriding this method is almost always a mistake, as this overload only exists to disambiguate. Instead, override the removeIf() overload that uses the JDK's primitive predicate type (e.g. IntPredicate).

        If Java supported final default methods, this would be one, but sadly it does not.

        If you checked and are overriding the version with java.util.function.XPredicate, and still see this warning, then your IDE is incorrectly conflating this method with the proper method to override, and you can safely ignore this message.

        Specified by:
        removeIf in interface LongCollection
        Parameters:
        filter - a predicate which returns true for elements to be removed.
        Returns:
        true if any elements were removed.
        See Also:
        Collection.removeIf(java.util.function.Predicate)
        API Notes:
        This method exists to make final what should have been final in the interface.
      • addAll

        public boolean addAll​(LongCollection c)
        Description copied from interface: LongCollection
        Adds all elements of the given type-specific collection to this collection.
        Specified by:
        addAll in interface LongCollection
        Parameters:
        c - a type-specific collection.
        Returns:
        true if this collection changed as a result of the call.
        See Also:
        Collection.addAll(Collection)
      • addAll

        public boolean addAll​(java.util.Collection<? extends java.lang.Long> c)
        Specified by:
        addAll in interface java.util.Collection<java.lang.Long>
        Overrides:
        addAll in class java.util.AbstractCollection<java.lang.Long>
        Implementation Specification:
        This implementation delegates to the type-specific version if given a type-specific collection, otherwise is uses the implementation from AbstractCollection.
      • containsAll

        public boolean containsAll​(LongCollection c)
        Description copied from interface: LongCollection
        Checks whether this collection contains all elements from the given type-specific collection.
        Specified by:
        containsAll in interface LongCollection
        Parameters:
        c - a type-specific collection.
        Returns:
        true if this collection contains all elements of the argument.
        See Also:
        Collection.containsAll(Collection)
      • containsAll

        public boolean containsAll​(java.util.Collection<?> c)
        Specified by:
        containsAll in interface java.util.Collection<java.lang.Long>
        Overrides:
        containsAll in class java.util.AbstractCollection<java.lang.Long>
        Implementation Specification:
        This implementation delegates to the type-specific version if given a type-specific collection, otherwise is uses the implementation from AbstractCollection.
      • removeAll

        public boolean removeAll​(LongCollection c)
        Description copied from interface: LongCollection
        Remove from this collection all elements in the given type-specific collection.
        Specified by:
        removeAll in interface LongCollection
        Parameters:
        c - a type-specific collection.
        Returns:
        true if this collection changed as a result of the call.
        See Also:
        Collection.removeAll(Collection)
      • removeAll

        public boolean removeAll​(java.util.Collection<?> c)
        Specified by:
        removeAll in interface java.util.Collection<java.lang.Long>
        Overrides:
        removeAll in class java.util.AbstractCollection<java.lang.Long>
        Implementation Specification:
        This implementation delegates to the type-specific version if given a type-specific collection, otherwise is uses the implementation from AbstractCollection.
      • retainAll

        public boolean retainAll​(LongCollection c)
        Description copied from interface: LongCollection
        Retains in this collection only elements from the given type-specific collection.
        Specified by:
        retainAll in interface LongCollection
        Parameters:
        c - a type-specific collection.
        Returns:
        true if this collection changed as a result of the call.
        See Also:
        Collection.retainAll(Collection)
      • retainAll

        public boolean retainAll​(java.util.Collection<?> c)
        Specified by:
        retainAll in interface java.util.Collection<java.lang.Long>
        Overrides:
        retainAll in class java.util.AbstractCollection<java.lang.Long>
        Implementation Specification:
        This implementation delegates to the type-specific version if given a type-specific collection, otherwise is uses the implementation from AbstractCollection.
      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.util.AbstractCollection<java.lang.Long>