Interface ByteIterable
- All Known Subinterfaces:
ByteBidirectionalIterable,ByteCollection,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
Iterable that strengthens that specification of iterator() and forEach(Consumer).
Note that whenever there exist a primitive consumer in java.util.function (e.g., IntConsumer),
trying to access any version of forEach(Consumer) using a lambda expression with untyped arguments
will generate an ambiguous method error. This can be easily solved by specifying the type of the argument, as in
intIterable.forEach((int x) -> { // Do something with x });
The same problem plagues, for example, PrimitiveIterator.OfInt.forEachRemaining(java.util.function.IntConsumer).
Warning: Java will let you write “colon” for statements with primitive-type
loop variables; however, what is (unfortunately) really happening is that at each iteration an
unboxing (and, in the case of fastutil type-specific data structures, a boxing) will be performed. Watch out.
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptiondefault voidforEach(it.unimi.dsi.fastutil.bytes.ByteConsumer action) Performs the given action for each element of this type-specificIterableuntil all elements have been processed or the action throws an exception.default voidDeprecated.Please use the corresponding type-specific method instead.default voidforEach(IntConsumer action) Performs the given action for each element of this type-specificIterable, performing widening primitive casts, until all elements have been processed or the action throws an exception.default it.unimi.dsi.fastutil.ints.IntIteratorReturns a widened primitive iterator on the elements of this iterable.default it.unimi.dsi.fastutil.ints.IntSpliteratorReturns widened primitive spliterator on the elements of this iterable.it.unimi.dsi.fastutil.bytes.ByteIteratoriterator()Returns a type-specific iterator.default it.unimi.dsi.fastutil.bytes.ByteSpliteratorReturns a type-specific spliterator on the elements of this iterable.
-
Method Details
-
iterator
it.unimi.dsi.fastutil.bytes.ByteIterator iterator()Returns a type-specific iterator. -
intIterator
default it.unimi.dsi.fastutil.ints.IntIterator intIterator()Returns a widened primitive iterator on the elements of this iterable.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.- Returns:
- a widened primitive iterator on the elements of this iterable.
- Since:
- 8.5.0
-
spliterator
default it.unimi.dsi.fastutil.bytes.ByteSpliterator spliterator()Returns a type-specific spliterator on the elements of this iterable.- Specified by:
spliteratorin interfaceIterable<Byte>- Returns:
- a type-specific spliterator on the elements of this iterable.
- Since:
- 8.5.0
-
intSpliterator
default it.unimi.dsi.fastutil.ints.IntSpliterator intSpliterator()Returns widened primitive spliterator on the elements of this iterable.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.- Returns:
- a widened primitive spliterator on the elements of this iterable.
- Since:
- 8.5.0
-
forEach
default void forEach(it.unimi.dsi.fastutil.bytes.ByteConsumer action) Performs the given action for each element of this type-specificIterableuntil all elements have been processed or the action throws an exception.- Parameters:
action- the action to be performed for each element.- Since:
- 8.0.0
- See Also:
-
forEach
Performs the given action for each element of this type-specificIterable, performing widening primitive casts, until all elements have been processed or the action throws an exception.- Parameters:
action- the action to be performed for each element.- Since:
- 8.0.0
- See Also:
-
forEach
Deprecated.Please use the corresponding type-specific method instead.
-