Interface LongCollection
- All Superinterfaces:
Collection<Long>,Iterable<Long>,LongIterable
- All Known Subinterfaces:
LongList
- All Known Implementing Classes:
AbstractLongCollection,AbstractLongList,AbstractLongList.LongRandomAccessSubList,AbstractLongList.LongSubList,LongArrayList,LongArrayList.SubList,LongCollections.EmptyCollection,LongCollections.IterableCollection,LongImmutableList,LongLists.EmptyList,LongLists.Singleton,LongLists.SynchronizedList,LongLists.SynchronizedRandomAccessList,LongLists.UnmodifiableList,LongLists.UnmodifiableRandomAccessList
Collection; provides some additional methods
that use polymorphism to avoid (un)boxing.
Additionally, this class defines strengthens (again) iterator().
This interface specifies reference equality semantics (members will be compared equal with
== instead of equals), which may result in breaks in contract
if attempted to be used with non reference-equality semantics based Collections. For example, a
aReferenceCollection.equals(aObjectCollection) may return different a different result then
aObjectCollection.equals(aReferenceCollection), in violation of equals's
contract requiring it being symmetric.
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionbooleanadd(long key) Ensures that this collection contains the specified element (optional operation).default booleanDeprecated.Please use the corresponding type-specific method instead.booleanAdds all elements of the given type-specific collection to this collection.booleancontains(long key) Returnstrueif this collection contains the specified element.default booleanDeprecated.Please use the corresponding type-specific method instead.booleanChecks whether this collection contains all elements from the given type-specific collection.it.unimi.dsi.fastutil.longs.LongIteratoriterator()Returns a type-specific iterator on the elements of this collection.default it.unimi.dsi.fastutil.longs.LongIteratorReturns a primitive iterator on the elements of this collection.default LongStreamReturn a parallel primitive stream over the elements, performing widening casts if needed.default it.unimi.dsi.fastutil.longs.LongSpliteratorReturns a primitive spliterator on the elements of this collection.default LongStreamReturn a primitive stream over the elements, performing widening casts if needed.Deprecated.Please use the corresponding type-specific method instead.booleanrem(long key) Removes a single instance of the specified element from this collection, if it is present (optional operation).default booleanDeprecated.Please use (and implement) therem()method instead.booleanRemove from this collection all elements in the given type-specific collection.default booleanremoveIf(LongPredicate filter) Remove from this collection all elements which satisfy the given predicate.default booleanremoveIf(LongPredicate filter) Remove from this collection all elements which satisfy the given predicate.default booleanDeprecated.Please use the corresponding type-specific method instead.booleanRetains in this collection only elements from the given type-specific collection.default it.unimi.dsi.fastutil.longs.LongSpliteratorReturns a type-specific spliterator on the elements of this collection.stream()Deprecated.Please use the corresponding type-specific method instead.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[]Returns a primitive type array containing the items of this collection.default long[]toLongArray(long[] a) Deprecated.Please usetoArray()instead—this method is redundant and will be removed in the future.Methods inherited from interface java.util.Collection
addAll, clear, containsAll, equals, hashCode, isEmpty, removeAll, retainAll, size, toArray, toArray, toArrayMethods inherited from interface it.unimi.dsi.fastutil.longs.LongIterable
forEach, forEach, forEach
-
Method Details
-
iterator
it.unimi.dsi.fastutil.longs.LongIterator iterator()Returns a type-specific iterator on the elements of this collection.- Specified by:
iteratorin interfaceCollection<Long>- Specified by:
iteratorin interfaceIterable<Long>- Specified by:
iteratorin interfaceLongIterable- Returns:
- a type-specific iterator on the elements of this collection.
- See Also:
-
longIterator
default it.unimi.dsi.fastutil.longs.LongIterator longIterator()Returns a primitive iterator on the elements of this collection.This method is identical to
iterator(), as the type-specific iterator is already compatible with the JDK's primitive iterators. It only exists for compatibility with the other primitive types'Collections that have use for widened iterators.- Specified by:
longIteratorin interfaceLongIterable- Returns:
- a primitive iterator on the elements of this collection.
- Since:
- 8.5.0
-
spliterator
default it.unimi.dsi.fastutil.longs.LongSpliterator spliterator()Returns a type-specific spliterator on the elements of this collection.See
Collection.spliterator()for more documentation on the requirements of the returned spliterator.- Specified by:
spliteratorin interfaceCollection<Long>- Specified by:
spliteratorin interfaceIterable<Long>- Specified by:
spliteratorin interfaceLongIterable- Returns:
- a type-specific spliterator on the elements of this collection.
- Since:
- 8.5.0
-
longSpliterator
default it.unimi.dsi.fastutil.longs.LongSpliterator longSpliterator()Returns a primitive spliterator on the elements of this collection.This method is identical to
spliterator(), as the type-specific spliterator is already compatible with the JDK's primitive spliterators. It only exists for compatibility with the other primitive types'Collections that have use for widened spliterators.- Specified by:
longSpliteratorin interfaceLongIterable- Returns:
- a primitive spliterator on the elements of this collection.
- Since:
- 8.5.0
-
add
boolean add(long key) Ensures that this collection contains the specified element (optional operation).- See Also:
-
contains
boolean contains(long key) Returnstrueif this collection contains the specified element.- See Also:
-
rem
boolean rem(long key) 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 theListinterface forces us to use a distinguished name. For simplicity, the set interfaces reinstatesremove().- See Also:
-
add
Deprecated.Please use the corresponding type-specific method instead.- Specified by:
addin interfaceCollection<Long>
-
contains
Deprecated.Please use the corresponding type-specific method instead.- Specified by:
containsin interfaceCollection<Long>
-
remove
Deprecated.Please use (and implement) therem()method instead.- Specified by:
removein interfaceCollection<Long>
-
toLongArray
long[] toLongArray()Returns a primitive type array containing the items of this collection.- Returns:
- a primitive type array containing the items of this collection.
- See Also:
-
toLongArray
Deprecated.Please usetoArray()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.- 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:
-
toArray
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.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.- 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:
-
addAll
Adds all elements of the given type-specific collection to this collection.- Parameters:
c- a type-specific collection.- Returns:
trueif this collection changed as a result of the call.- See Also:
-
containsAll
Checks whether this collection contains all elements from the given type-specific collection.- Parameters:
c- a type-specific collection.- Returns:
trueif this collection contains all elements of the argument.- See Also:
-
removeAll
Remove from this collection all elements in the given type-specific collection.- Parameters:
c- a type-specific collection.- Returns:
trueif this collection changed as a result of the call.- See Also:
-
removeIf
Deprecated.Please use the corresponding type-specific method instead.- Specified by:
removeIfin interfaceCollection<Long>
-
removeIf
Remove from this collection all elements which satisfy the given predicate.- Parameters:
filter- a predicate which returnstruefor elements to be removed.- Returns:
trueif any elements were removed.- See Also:
-
removeIf
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.- Parameters:
filter- a predicate which returnstruefor elements to be removed.- Returns:
trueif any elements were removed.- See Also:
-
retainAll
Retains in this collection only elements from the given type-specific collection.- Parameters:
c- a type-specific collection.- Returns:
trueif this collection changed as a result of the call.- See Also:
-
stream
Deprecated.Please use the corresponding type-specific method instead.- Specified by:
streamin interfaceCollection<Long>
-
longStream
Return a primitive stream over the elements, performing widening casts if needed.- Returns:
- a primitive stream over the elements.
- See Also:
-
parallelStream
Deprecated.Please use the corresponding type-specific method instead.- Specified by:
parallelStreamin interfaceCollection<Long>
-
longParallelStream
Return a parallel primitive stream over the elements, performing widening casts if needed.- Returns:
- a parallel primitive stream over the elements.
- See Also:
-