public interface ByteCollection extends Collection<Byte>, ByteIterable
Collection; provides some additional methods that use
polymorphism to avoid (un)boxing.
Additionally, this class defines strengthens (again) iterator().
Collection| Modifier and Type | Method and Description |
|---|---|
boolean |
add(byte key)
Ensures that this collection contains the specified element (optional
operation).
|
boolean |
add(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. |
boolean |
contains(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.
|
ByteIterator |
iterator()
Returns a type-specific iterator on the elements of this collection.
|
boolean |
rem(byte key)
Removes a single instance of the specified element from this collection,
if it is present (optional operation).
|
boolean |
remove(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.
|
boolean |
retainAll(ByteCollection c)
Retains in this collection only elements from the given type-specific
collection.
|
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.
|
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, parallelStream, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArrayforEach, forEachByteIterator iterator()
Note that this specification strengthens the one given in
Iterable.iterator(), which was already strengthened in
the corresponding type-specific class, but was weakened by the fact that
this interface extends Collection.
iterator in interface ByteIterableiterator in interface Collection<Byte>iterator in interface Iterable<Byte>Iterable.iterator()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 boolean add(Byte key)
Collections that support this operation may place limitations on what elements may be added to this collection. In particular, some collections will refuse to add null elements, and others will impose restrictions on the type of elements that may be added. Collection classes should clearly specify in their documentation any restrictions on what elements may be added.
If a collection refuses to add a particular element for any reason other than that it already contains the element, it must throw an exception (rather than returning false). This preserves the invariant that a collection always contains the specified element after this call returns.
add in interface Collection<Byte>key - element whose presence in this collection is to be ensured@Deprecated boolean contains(Object key)
contains in interface Collection<Byte>key - element whose presence in this collection is to be tested@Deprecated boolean remove(Object key)
rem() method instead.remove in interface Collection<Byte>key - element to be removed from this collection, if presentbyte[] toByteArray()
Collection.toArray()@Deprecated 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)boolean retainAll(ByteCollection c)
c - a type-specific collection.true if this collection changed as a result of the call.Collection.retainAll(Collection)