Interface ByteCollection
- All Superinterfaces:
ByteIterable,Collection<Byte>,Iterable<Byte>
- All Known Subinterfaces:
ByteList
- All Known Implementing Classes:
AbstractByteCollection,AbstractByteList,AbstractByteList.ByteRandomAccessSubList,AbstractByteList.ByteSubList,ByteArrayList,ByteArrayList.SubList,ByteCollections.EmptyCollection,ByteCollections.IterableCollection,ByteImmutableList,ByteLists.EmptyList,ByteLists.Singleton,ByteLists.SynchronizedList,ByteLists.SynchronizedRandomAccessList,ByteLists.UnmodifiableList,ByteLists.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(byte 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(byte 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.default it.unimi.dsi.fastutil.ints.IntIteratorReturns a widened primitive iterator on the elements of this collection.default IntStreamReturn a parallel primitive stream over the elements, performing widening casts if needed.default it.unimi.dsi.fastutil.ints.IntSpliteratorReturns widened primitive spliterator on the elements of this collection.default IntStreamReturn a primitive stream over the elements, performing widening casts if needed.it.unimi.dsi.fastutil.bytes.ByteIteratoriterator()Returns a type-specific iterator on the elements of this collection.Deprecated.Please use the corresponding type-specific method instead.booleanrem(byte 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(BytePredicate filter) Remove from this collection all elements which satisfy the given predicate.default booleanremoveIf(IntPredicate 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.bytes.ByteSpliteratorReturns a type-specific spliterator on the elements of this collection.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[]Returns a primitive type array containing the items of this collection.default byte[]toByteArray(byte[] a) Deprecated.Please usetoArray()instead—this method is redundant and will be removed in the future.Methods inherited from interface it.unimi.dsi.fastutil.bytes.ByteIterable
forEach, forEach, forEach
-
Method Details
-
iterator
it.unimi.dsi.fastutil.bytes.ByteIterator iterator()Returns a type-specific iterator on the elements of this collection.- Specified by:
iteratorin interfaceByteIterable- Specified by:
iteratorin interfaceCollection<Byte>- Specified by:
iteratorin interfaceIterable<Byte>- Returns:
- a type-specific iterator on the elements of this collection.
- See Also:
-
intIterator
default it.unimi.dsi.fastutil.ints.IntIterator intIterator()Returns a widened primitive iterator on the elements of this collection.This method is provided for the purpose of APIs that expect only the JDK's primitive iterators, of which there are only
int,long, anddouble.- Specified by:
intIteratorin interfaceByteIterable- Returns:
- a widened primitive iterator on the elements of this collection.
- Since:
- 8.5.0
-
spliterator
default it.unimi.dsi.fastutil.bytes.ByteSpliterator 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 interfaceByteIterable- Specified by:
spliteratorin interfaceCollection<Byte>- Specified by:
spliteratorin interfaceIterable<Byte>- Returns:
- a type-specific spliterator on the elements of this collection.
- Since:
- 8.5.0
-
intSpliterator
default it.unimi.dsi.fastutil.ints.IntSpliterator intSpliterator()Returns widened primitive spliterator on the elements of this collection.This method is provided for the purpose of APIs that expect only the JDK's primitive spliterators, of which there are only
int,long, anddouble.- Specified by:
intSpliteratorin interfaceByteIterable- Returns:
- a widened primitive spliterator on the elements of this collection.
- Since:
- 8.5.0
-
add
boolean add(byte key) Ensures that this collection contains the specified element (optional operation).- See Also:
-
contains
boolean contains(byte key) Returnstrueif this collection contains the specified element.- See Also:
-
rem
boolean rem(byte 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<Byte>
-
contains
Deprecated.Please use the corresponding type-specific method instead.- Specified by:
containsin interfaceCollection<Byte>
-
remove
Deprecated.Please use (and implement) therem()method instead.- Specified by:
removein interfaceCollection<Byte>
-
toByteArray
byte[] toByteArray()Returns a primitive type array containing the items of this collection.- Returns:
- a primitive type array containing the items of this collection.
- See Also:
-
toByteArray
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
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.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<Byte>
-
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.- 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<Byte>
-
intStream
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<Byte>
-
intParallelStream
Return a parallel primitive stream over the elements, performing widening casts if needed.- Returns:
- a parallel primitive stream over the elements.
- See Also:
-