public interface FloatCollection extends java.util.Collection<java.lang.Float>, FloatIterable
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 Collection
s. 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.
Collection
Modifier and Type | Method and Description |
---|---|
boolean |
add(float key)
Ensures that this collection contains the specified element (optional operation).
|
default boolean |
add(java.lang.Float key)
Deprecated.
Please use the corresponding type-specific method instead.
|
boolean |
addAll(FloatCollection c)
Adds all elements of the given type-specific collection to this collection.
|
boolean |
contains(float key)
Returns
true if this collection contains the specified element. |
default boolean |
contains(java.lang.Object key)
Deprecated.
Please use the corresponding type-specific method instead.
|
boolean |
containsAll(FloatCollection c)
Checks whether this collection contains all elements from the given type-specific collection.
|
default DoubleIterator |
doubleIterator()
Returns a widened primitive iterator on the elements of this collection.
|
default java.util.stream.DoubleStream |
doubleParallelStream()
Return a parallel primitive stream over the elements, performing widening casts if needed.
|
default DoubleSpliterator |
doubleSpliterator()
Returns widened primitive spliterator on the elements of this collection.
|
default java.util.stream.DoubleStream |
doubleStream()
Return a primitive stream over the elements, performing widening casts if needed.
|
FloatIterator |
iterator()
Returns a type-specific iterator on the elements of this collection.
|
default java.util.stream.Stream<java.lang.Float> |
parallelStream()
Deprecated.
Please use the corresponding type-specific method instead.
|
boolean |
rem(float key)
Removes a single instance of the specified element from this
collection, if it is present (optional operation).
|
default boolean |
remove(java.lang.Object key)
Deprecated.
Please use (and implement) the
rem() method instead. |
boolean |
removeAll(FloatCollection c)
Remove from this collection all elements in the given type-specific collection.
|
default boolean |
removeIf(java.util.function.DoublePredicate filter)
Remove from this collection all elements which satisfy the given predicate.
|
default boolean |
removeIf(FloatPredicate filter)
Remove from this collection all elements which satisfy the given predicate.
|
default boolean |
removeIf(java.util.function.Predicate<? super java.lang.Float> filter)
Deprecated.
Please use the corresponding type-specific method instead.
|
boolean |
retainAll(FloatCollection c)
Retains in this collection only elements from the given type-specific collection.
|
default FloatSpliterator |
spliterator()
Returns a type-specific spliterator on the elements of this collection.
|
default java.util.stream.Stream<java.lang.Float> |
stream()
Deprecated.
Please use the corresponding type-specific method instead.
|
float[] |
toArray(float[] 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.
|
float[] |
toFloatArray()
Returns a primitive type array containing the items of this collection.
|
default float[] |
toFloatArray(float[] a)
Deprecated.
Please use
toArray() instead—this method is redundant and will be removed in the future. |
addAll, clear, containsAll, equals, hashCode, isEmpty, removeAll, retainAll, size, toArray, toArray
forEach, forEach, forEach
FloatIterator iterator()
iterator
in interface java.util.Collection<java.lang.Float>
iterator
in interface FloatIterable
iterator
in interface java.lang.Iterable<java.lang.Float>
Iterable.iterator()
Iterable.iterator()
, which was already
strengthened in the corresponding type-specific class,
but was weakened by the fact that this interface extends Collection
.default DoubleIterator doubleIterator()
This method is provided for the purpose of APIs that expect only the JDK's
primitive iterators, of which there are only int
, long
, and double
.
doubleIterator
in interface FloatIterable
default FloatSpliterator spliterator()
See Collection.spliterator()
for more documentation on the requirements
of the returned spliterator.
spliterator
in interface java.util.Collection<java.lang.Float>
spliterator
in interface FloatIterable
spliterator
in interface java.lang.Iterable<java.lang.Float>
Collection.spliterator()
.
Also, this is generally the only spliterator
method subclasses should override.
Spliterator
for documentation on what binding policies mean)
that wraps this instance's type specific iterator()
.
Additionally, it reports Spliterator.SIZED
Iterator
is an inherently linear API, the returned spliterator will yield limited performance gains
when run in parallel contexts, as the returned spliterator's
trySplit()
will have linear runtime.default DoubleSpliterator doubleSpliterator()
This method is provided for the purpose of APIs that expect only the JDK's
primitive spliterators, of which there are only int
, long
, and double
.
doubleSpliterator
in interface FloatIterable
boolean add(float key)
Collection.add(Object)
boolean contains(float key)
true
if this collection contains the specified element.Collection.contains(Object)
boolean rem(float key)
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()
.
Collection.remove(Object)
@Deprecated default boolean add(java.lang.Float key)
add
in interface java.util.Collection<java.lang.Float>
@Deprecated default boolean contains(java.lang.Object key)
contains
in interface java.util.Collection<java.lang.Float>
@Deprecated default boolean remove(java.lang.Object key)
rem()
method instead.remove
in interface java.util.Collection<java.lang.Float>
float[] toFloatArray()
Collection.toArray()
@Deprecated default float[] toFloatArray(float[] a)
toArray()
instead—this method is redundant and will be removed in the future.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.
a
- if this array is big enough, it will be used to store this collection.Collection.toArray(Object[])
float[] toArray(float[] a)
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.
a
- if this array is big enough, it will be used to store this collection.Collection.toArray(Object[])
boolean addAll(FloatCollection c)
c
- a type-specific collection.true
if this collection changed as a result of the call.Collection.addAll(Collection)
boolean containsAll(FloatCollection c)
c
- a type-specific collection.true
if this collection contains all elements of the argument.Collection.containsAll(Collection)
boolean removeAll(FloatCollection c)
c
- a type-specific collection.true
if this collection changed as a result of the call.Collection.removeAll(Collection)
@Deprecated default boolean removeIf(java.util.function.Predicate<? super java.lang.Float> filter)
removeIf
in interface java.util.Collection<java.lang.Float>
default boolean removeIf(FloatPredicate filter)
filter
- a predicate which returns true
for elements to be
removed.true
if any elements were removed.Collection.removeIf(java.util.function.Predicate)
default boolean removeIf(java.util.function.DoublePredicate filter)
filter
- a predicate which returns true
for elements to be
removed.true
if any elements were removed.Collection.removeIf(java.util.function.Predicate)
boolean retainAll(FloatCollection c)
c
- a type-specific collection.true
if this collection changed as a result of the call.Collection.retainAll(Collection)
@Deprecated default java.util.stream.Stream<java.lang.Float> stream()
stream
in interface java.util.Collection<java.lang.Float>
default java.util.stream.DoubleStream doubleStream()
Collection.stream()
,
IntStream
@Deprecated default java.util.stream.Stream<java.lang.Float> parallelStream()
parallelStream
in interface java.util.Collection<java.lang.Float>
default java.util.stream.DoubleStream doubleParallelStream()
Collection.parallelStream()
,
IntStream