Package io.deephaven.engine.primitive.value.iterator

Interface ValueIteratorOfByte

All Superinterfaces:

AutoCloseable, CloseableIterator<Byte>, CloseablePrimitiveIterator<Byte,ByteConsumer>, CloseablePrimitiveIteratorOfByte, Iterator<Byte>, PrimitiveIterator<Byte,ByteConsumer>, ValueIterator<Byte>

All Known Subinterfaces:

ByteColumnIterator

All Known Implementing Classes:

ChunkedByteColumnIterator, SerialByteColumnIterator

public interface ValueIteratorOfByte
extends CloseablePrimitiveIteratorOfByte, ValueIterator<Byte>

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.PrimitiveIterator

PrimitiveIterator.OfDouble, PrimitiveIterator.OfInt, PrimitiveIterator.OfLong

Field Summary

Fields

Modifier and Type	Field	Description
static final ValueIteratorOfByte	EMPTY	A re-usable, immutable ValueIteratorOfByte with no elements.

Method Summary

Modifier and Type	Method	Description
static ValueIteratorOfByte	empty()	Get a ValueIteratorOfByte with no elements.
default void	forEachRemaining(@NotNull Consumer<? super Byte> action)
default Byte	next()
static ValueIteratorOfByte	of(@org.jetbrains.annotations.NotNull byte... values)	Create a ValueIteratorOfByte over an array of byte.
default IntStream	streamAsInt()	Create an unboxed IntStream over the remaining elements of this ValueIteratorOfByte by casting each element to int with the appropriate adjustment of NULL_BYTE to NULL_INT.
default IntStream	streamAsInt(@NotNull ByteToIntFunction adapter)	Create an IntStream over the remaining elements of this ValueIteratorOfByte by applying adapter to each element.
static ValueIteratorOfByte	wrapWithNulls(@Nullable ValueIteratorOfByte iterator, long prefixNulls, long postfixNulls)	Wraps a ValueIteratorOfByte with set number of prefix nulls, postfix nulls, or both.

Methods inherited from interface io.deephaven.engine.primitive.iterator.CloseableIterator

close

Methods inherited from interface io.deephaven.engine.primitive.iterator.CloseablePrimitiveIteratorOfByte

adaptToOfInt, forEachRemaining, nextByte

Methods inherited from interface java.util.Iterator

hasNext, remove

Methods inherited from interface io.deephaven.engine.primitive.value.iterator.ValueIterator

remaining, stream

Field Details

EMPTY

static final ValueIteratorOfByte EMPTY

A re-usable, immutable ValueIteratorOfByte with no elements.

Method Details

next

@FinalDefault
default Byte next()

Specified by:

next in interface CloseablePrimitiveIteratorOfByte

Specified by:

next in interface Iterator<Byte>

forEachRemaining

@FinalDefault
default void forEachRemaining(@NotNull
 @NotNull Consumer<? super Byte> action)

Specified by:

forEachRemaining in interface CloseablePrimitiveIteratorOfByte

Specified by:

forEachRemaining in interface Iterator<Byte>

streamAsInt

@FinalDefault
default IntStream streamAsInt()

Create an unboxed IntStream over the remaining elements of this ValueIteratorOfByte by casting each element to int with the appropriate adjustment of NULL_BYTE to NULL_INT. The result must be closed in order to ensure resources are released. A try-with-resources block is strongly encouraged.

Specified by:

streamAsInt in interface CloseablePrimitiveIteratorOfByte

Returns:

An unboxed IntStream over the remaining contents of this iterator. Must be closed.

streamAsInt

@FinalDefault
default IntStream streamAsInt(@NotNull
 @NotNull ByteToIntFunction adapter)

Create an IntStream over the remaining elements of this ValueIteratorOfByte by applying adapter to each element. The result must be closed in order to ensure resources are released. A try-with-resources block is strongly encouraged.

Specified by:

streamAsInt in interface CloseablePrimitiveIteratorOfByte

Returns:

An IntStream over the remaining contents of this iterator. Must be closed.

empty

static ValueIteratorOfByte empty()

Get a ValueIteratorOfByte with no elements. The result does not need to be closed.

Returns:

A ValueIteratorOfByte with no elements

of

static ValueIteratorOfByte of(@NotNull
 @org.jetbrains.annotations.NotNull byte... values)

Create a ValueIteratorOfByte over an array of byte. The result does not need to be closed.

Parameters:

values - The elements to iterate

Returns:

A ValueIteratorOfByte of values

wrapWithNulls

static ValueIteratorOfByte wrapWithNulls(@Nullable
 @Nullable ValueIteratorOfByte iterator,
 long prefixNulls,
 long postfixNulls)

Wraps a ValueIteratorOfByte with set number of prefix nulls, postfix nulls, or both. The result must be closed.

Parameters:

iterator - The ValueIteratorOfByte to wrap

prefixNulls - The number of nulls to add to the beginning of the iterator

postfixNulls - The number of nulls to add to the end of the iterator

Returns:

A ValueIteratorOfByte with the specified number of prefix and postfix nulls