public interface ByteCollection extends java.util.Collection<java.lang.Byte>, ByteIterable
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(byte key)
Ensures that this collection contains the specified element (optional operation).
|
default boolean |
add(java.lang.Byte key)
Deprecated.
Please use the corresponding type-specific method instead.
|
boolean |
addAll(ByteCollection c)
Adds all elements of the given type-specific collection to this collection.
|
boolean |
contains(byte 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(ByteCollection c)
Checks whether this collection contains all elements from the given type-specific collection.
|
default IntIterator |
intIterator()
Returns a widened primitive iterator on the elements of this collection.
|
default java.util.stream.IntStream |
intParallelStream()
Return a parallel primitive stream over the elements, performing widening casts if needed.
|
default IntSpliterator |
intSpliterator()
Returns widened primitive spliterator on the elements of this collection.
|
default java.util.stream.IntStream |
intStream()
Return a primitive stream over the elements, performing widening casts if needed.
|
ByteIterator |
iterator()
Returns a type-specific iterator on the elements of this collection.
|
default java.util.stream.Stream<java.lang.Byte> |
parallelStream()
Deprecated.
Please use the corresponding type-specific method instead.
|
boolean |
rem(byte 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(ByteCollection c)
Remove from this collection all elements in the given type-specific collection.
|
default boolean |
removeIf(BytePredicate filter)
Remove from this collection all elements which satisfy the given predicate.
|
default boolean |
removeIf(java.util.function.IntPredicate filter)
Remove from this collection all elements which satisfy the given predicate.
|
default boolean |
removeIf(java.util.function.Predicate<? super java.lang.Byte> filter)
Deprecated.
Please use the corresponding type-specific method instead.
|
boolean |
retainAll(ByteCollection c)
Retains in this collection only elements from the given type-specific collection.
|
default ByteSpliterator |
spliterator()
Returns a type-specific spliterator on the elements of this collection.
|
default java.util.stream.Stream<java.lang.Byte> |
stream()
Deprecated.
Please use the corresponding type-specific method instead.
|
byte[] |
toArray(byte[] 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.
|
byte[] |
toByteArray()
Returns a primitive type array containing the items of this collection.
|
default byte[] |
toByteArray(byte[] 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
ByteIterator iterator()
iterator
in interface ByteIterable
iterator
in interface java.util.Collection<java.lang.Byte>
iterator
in interface java.lang.Iterable<java.lang.Byte>
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 IntIterator intIterator()
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
.
intIterator
in interface ByteIterable
default ByteSpliterator spliterator()
See Collection.spliterator()
for more documentation on the requirements
of the returned spliterator.
spliterator
in interface ByteIterable
spliterator
in interface java.util.Collection<java.lang.Byte>
spliterator
in interface java.lang.Iterable<java.lang.Byte>
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 IntSpliterator intSpliterator()
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
.
intSpliterator
in interface ByteIterable
boolean add(byte key)
Collection.add(Object)
boolean contains(byte key)
true
if this collection contains the specified element.Collection.contains(Object)
boolean rem(byte 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.Byte key)
add
in interface java.util.Collection<java.lang.Byte>
@Deprecated default boolean contains(java.lang.Object key)
contains
in interface java.util.Collection<java.lang.Byte>
@Deprecated default boolean remove(java.lang.Object key)
rem()
method instead.remove
in interface java.util.Collection<java.lang.Byte>
byte[] toByteArray()
Collection.toArray()
@Deprecated default byte[] toByteArray(byte[] 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[])
byte[] toArray(byte[] 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(ByteCollection c)
c
- a type-specific collection.true
if this collection changed as a result of the call.Collection.addAll(Collection)
boolean containsAll(ByteCollection c)
c
- a type-specific collection.true
if this collection contains all elements of the argument.Collection.containsAll(Collection)
boolean removeAll(ByteCollection 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.Byte> filter)
removeIf
in interface java.util.Collection<java.lang.Byte>
default boolean removeIf(BytePredicate 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.IntPredicate 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(ByteCollection 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.Byte> stream()
stream
in interface java.util.Collection<java.lang.Byte>
default java.util.stream.IntStream intStream()
Collection.stream()
,
IntStream
@Deprecated default java.util.stream.Stream<java.lang.Byte> parallelStream()
parallelStream
in interface java.util.Collection<java.lang.Byte>
default java.util.stream.IntStream intParallelStream()
Collection.parallelStream()
,
IntStream