Package org.eclipse.collections.api
Interface ByteIterable
-
- All Superinterfaces:
PrimitiveIterable
- All Known Subinterfaces:
ByteBag,ByteByteMap,ByteList,ByteSet,ByteStack,ByteValuesMap,CharByteMap,DoubleByteMap,FloatByteMap,ImmutableByteBag,ImmutableByteByteMap,ImmutableByteCollection,ImmutableByteList,ImmutableByteSet,ImmutableByteStack,ImmutableCharByteMap,ImmutableDoubleByteMap,ImmutableFloatByteMap,ImmutableIntByteMap,ImmutableLongByteMap,ImmutableObjectByteMap<K>,ImmutableShortByteMap,IntByteMap,LazyByteIterable,LongByteMap,MutableByteBag,MutableByteByteMap,MutableByteCollection,MutableByteList,MutableByteSet,MutableByteStack,MutableByteValuesMap,MutableCharByteMap,MutableDoubleByteMap,MutableFloatByteMap,MutableIntByteMap,MutableLongByteMap,MutableObjectByteMap<K>,MutableShortByteMap,ObjectByteMap<K>,OrderedByteIterable,ReversibleByteIterable,ShortByteMap
public interface ByteIterable extends PrimitiveIterable
ByteIterable is an interface which is memory-optimized for byte primitives. It is inspired by the interface RichIterable, and contains a subset of the internal iterator methods on RichIterable like collect, sum, etc. The API also includes an external iterator method, which returns an ByteIterator. ByteIterator helps iterate over the ByteIterable without boxing the primitives. This file was automatically generated from template file primitiveIterable.stg.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description booleanallSatisfy(BytePredicate predicate)Returns true if all of the elements in the ByteIterable return true for the specified predicate, otherwise returns false.booleananySatisfy(BytePredicate predicate)Returns true if any of the elements in the ByteIterable return true for the specified predicate, otherwise returns false.LazyByteIterableasLazy()Returns a LazyByteIterable adapter wrapping the source ByteIterable.doubleaverage()default doubleaverageIfEmpty(double defaultValue)ByteIteratorbyteIterator()Returns a primitive iterator that can be used to iterate over the ByteIterable in an imperative style.default RichIterable<ByteIterable>chunk(int size)Partitions elements in fixed size chunks.<V> RichIterable<V>collect(ByteToObjectFunction<? extends V> function)Returns a new collection with the results of applying the specified function on each element of the source collection.default <V,R extends Collection<V>>
Rcollect(ByteToObjectFunction<? extends V> function, R target)Same ascollect(ByteToObjectFunction), only the results are added to the target Collection.default <R extends MutableBooleanCollection>
RcollectBoolean(ByteToBooleanFunction function, R target)Returns the targetMutableBooleanCollectionwith the results of applying the specified function on each element of the source collection.default <R extends MutableByteCollection>
RcollectByte(ByteToByteFunction function, R target)Returns the targetMutableByteCollectionwith the results of applying the specified function on each element of the source collection.default <R extends MutableCharCollection>
RcollectChar(ByteToCharFunction function, R target)Returns the targetMutableCharCollectionwith the results of applying the specified function on each element of the source collection.default <R extends MutableDoubleCollection>
RcollectDouble(ByteToDoubleFunction function, R target)Returns the targetMutableDoubleCollectionwith the results of applying the specified function on each element of the source collection.default <R extends MutableFloatCollection>
RcollectFloat(ByteToFloatFunction function, R target)Returns the targetMutableFloatCollectionwith the results of applying the specified function on each element of the source collection.default <R extends MutableIntCollection>
RcollectInt(ByteToIntFunction function, R target)Returns the targetMutableIntCollectionwith the results of applying the specified function on each element of the source collection.default <R extends MutableLongCollection>
RcollectLong(ByteToLongFunction function, R target)Returns the targetMutableLongCollectionwith the results of applying the specified function on each element of the source collection.default <R extends MutableShortCollection>
RcollectShort(ByteToShortFunction function, R target)Returns the targetMutableShortCollectionwith the results of applying the specified function on each element of the source collection.booleancontains(byte value)Returns true if the value is contained in the ByteIterable, and false if it is not.default booleancontainsAll(byte... source)Returns true if all of the values specified in the source array are contained in the ByteIterable, and false if they are not.default booleancontainsAll(ByteIterable source)Returns true if all of the values specified in the source ByteIterable are contained in the ByteIterable, and false if they are not.default booleancontainsAny(byte... source)Returns true if any of the values specified in the source array are contained in the ByteIterable, and false if they are not.default booleancontainsAny(ByteIterable source)Returns true if any of the values specified in the source ByteIterable are contained in the ByteIterable, and false if they are not.default booleancontainsNone(byte... source)Returns true if none of the values specified in the source array are contained in the ByteIterable, and false if they are.default booleancontainsNone(ByteIterable source)Returns true if none of the values specified in the source ByteIterable are contained in the ByteIterable, and false if they are.intcount(BytePredicate predicate)Returns a count of the number of elements in the ByteIterable that return true for the specified predicate.bytedetectIfNone(BytePredicate predicate, byte ifNone)voideach(ByteProcedure procedure)A synonym for forEach.default <V,R extends Collection<V>>
RflatCollect(ByteToObjectFunction<? extends Iterable<V>> function, R target)flatCollectis a special case ofcollect(ByteToObjectFunction).default voidforEach(ByteProcedure procedure)Applies the ByteProcedure to each element in the ByteIterable.<T> TinjectInto(T injectedValue, ObjectByteToObjectFunction<? super T,? extends T> function)default booleaninjectIntoBoolean(boolean injectedValue, BooleanByteToBooleanFunction function)Returns the final boolean result of evaluating function using each element of the iterable and the previous evaluation result as the parameters.default byteinjectIntoByte(byte injectedValue, ByteByteToByteFunction function)Returns the final byte result of evaluating function using each element of the iterable and the previous evaluation result as the parameters.default charinjectIntoChar(char injectedValue, CharByteToCharFunction function)Returns the final char result of evaluating function using each element of the iterable and the previous evaluation result as the parameters.default doubleinjectIntoDouble(double injectedValue, DoubleByteToDoubleFunction function)Returns the final double result of evaluating function using each element of the iterable and the previous evaluation result as the parameters.default floatinjectIntoFloat(float injectedValue, FloatByteToFloatFunction function)Returns the final float result of evaluating function using each element of the iterable and the previous evaluation result as the parameters.default intinjectIntoInt(int injectedValue, IntByteToIntFunction function)Returns the final int result of evaluating function using each element of the iterable and the previous evaluation result as the parameters.default longinjectIntoLong(long injectedValue, LongByteToLongFunction function)Returns the final long result of evaluating function using each element of the iterable and the previous evaluation result as the parameters.default shortinjectIntoShort(short injectedValue, ShortByteToShortFunction function)Returns the final short result of evaluating function using each element of the iterable and the previous evaluation result as the parameters.bytemax()bytemaxIfEmpty(byte defaultValue)doublemedian()default doublemedianIfEmpty(double defaultValue)bytemin()byteminIfEmpty(byte defaultValue)default booleannoneSatisfy(BytePredicate predicate)Returns true if none of the elements in the ByteIterable return true for the specified predicate, otherwise returns false.default longreduce(LongByteToLongFunction accumulator)default longreduceIfEmpty(LongByteToLongFunction accumulator, long defaultValue)ByteIterablereject(BytePredicate predicate)Returns a new ByteIterable with all of the elements in the ByteIterable that return false for the specified predicate.default <R extends MutableByteCollection>
Rreject(BytePredicate predicate, R target)Same asreject(BytePredicate), only the results are added to the target MutableByteCollection.ByteIterableselect(BytePredicate predicate)Returns a new ByteIterable with all of the elements in the ByteIterable that return true for the specified predicate.default <R extends MutableByteCollection>
Rselect(BytePredicate predicate, R target)Same asselect(BytePredicate), only the results are added to the target MutableByteCollection.longsum()default IntSummaryStatisticssummaryStatistics()default ByteIterabletap(ByteProcedure procedure)byte[]toArray()Converts the ByteIterable to a primitive byte array.default byte[]toArray(byte[] target)Converts the ByteIterable to a primitive byte array.MutableByteBagtoBag()Converts the ByteIterable to a new MutableByteBag.MutableByteListtoList()Converts the ByteIterable to a new MutableByteList.MutableByteSettoSet()Converts the ByteIterable to a new MutableByteSet.byte[]toSortedArray()MutableByteListtoSortedList()default MutableByteListtoSortedList(ByteComparator comparator)Converts the collection to a MutableByteList implementation sorted using the provided comparator.default <T> MutableByteListtoSortedListBy(ByteToObjectFunction<T> function)Converts the collection to a MutableByteListImplementation sorted based on the natural order of the key returned byfunction.default <T> MutableByteListtoSortedListBy(ByteToObjectFunction<T> function, Comparator<? super T> comparator)Converts the collection to a MutableByteList implementation, which is sorted based on the key returned byfunctionusing the providedcomparator.-
Methods inherited from interface org.eclipse.collections.api.PrimitiveIterable
appendString, appendString, appendString, isEmpty, makeString, makeString, makeString, notEmpty, size, toString
-
-
-
-
Method Detail
-
byteIterator
ByteIterator byteIterator()
Returns a primitive iterator that can be used to iterate over the ByteIterable in an imperative style.
-
toArray
byte[] toArray()
Converts the ByteIterable to a primitive byte array.
-
toArray
default byte[] toArray(byte[] target)
Converts the ByteIterable to a primitive byte array. If the collection fits into the provided array it is used to store its elements and is returned from the method, otherwise a new array of the appropriate size is allocated and returned. If the iterable is empty, the target array is returned unchanged.
-
contains
boolean contains(byte value)
Returns true if the value is contained in the ByteIterable, and false if it is not.
-
containsAll
default boolean containsAll(byte... source)
Returns true if all of the values specified in the source array are contained in the ByteIterable, and false if they are not.
-
containsAll
default boolean containsAll(ByteIterable source)
Returns true if all of the values specified in the source ByteIterable are contained in the ByteIterable, and false if they are not.
-
containsAny
default boolean containsAny(byte... source)
Returns true if any of the values specified in the source array are contained in the ByteIterable, and false if they are not.- Since:
- 11.0
-
containsAny
default boolean containsAny(ByteIterable source)
Returns true if any of the values specified in the source ByteIterable are contained in the ByteIterable, and false if they are not.- Since:
- 11.0
-
containsNone
default boolean containsNone(byte... source)
Returns true if none of the values specified in the source array are contained in the ByteIterable, and false if they are.- Since:
- 11.0
-
containsNone
default boolean containsNone(ByteIterable source)
Returns true if none of the values specified in the source ByteIterable are contained in the ByteIterable, and false if they are.- Since:
- 11.0
-
forEach
default void forEach(ByteProcedure procedure)
Applies the ByteProcedure to each element in the ByteIterable.
-
each
void each(ByteProcedure procedure)
A synonym for forEach.- Since:
- 7.0.
-
tap
default ByteIterable tap(ByteProcedure procedure)
- Since:
- 9.0.
-
select
ByteIterable select(BytePredicate predicate)
Returns a new ByteIterable with all of the elements in the ByteIterable that return true for the specified predicate.
-
reject
ByteIterable reject(BytePredicate predicate)
Returns a new ByteIterable with all of the elements in the ByteIterable that return false for the specified predicate.
-
select
default <R extends MutableByteCollection> R select(BytePredicate predicate, R target)
Same asselect(BytePredicate), only the results are added to the target MutableByteCollection.- Since:
- 8.1.
-
reject
default <R extends MutableByteCollection> R reject(BytePredicate predicate, R target)
Same asreject(BytePredicate), only the results are added to the target MutableByteCollection.- Since:
- 8.1.
-
collect
<V> RichIterable<V> collect(ByteToObjectFunction<? extends V> function)
Returns a new collection with the results of applying the specified function on each element of the source collection. This method is also commonly called transform or map.
-
collect
default <V,R extends Collection<V>> R collect(ByteToObjectFunction<? extends V> function, R target)
Same ascollect(ByteToObjectFunction), only the results are added to the target Collection.- Since:
- 8.1.
-
flatCollect
default <V,R extends Collection<V>> R flatCollect(ByteToObjectFunction<? extends Iterable<V>> function, R target)
flatCollectis a special case ofcollect(ByteToObjectFunction). Withcollect, when theByteToObjectFunctionreturns a collection, the result is a collection of collections.flatCollectoutputs a single "flattened" collection instead. This method is commonly called flatMap.- Since:
- 8.1.
-
collectBoolean
default <R extends MutableBooleanCollection> R collectBoolean(ByteToBooleanFunction function, R target)
Returns the targetMutableBooleanCollectionwith the results of applying the specified function on each element of the source collection.- Since:
- 8.1.
-
collectByte
default <R extends MutableByteCollection> R collectByte(ByteToByteFunction function, R target)
Returns the targetMutableByteCollectionwith the results of applying the specified function on each element of the source collection.- Since:
- 8.1.
-
collectChar
default <R extends MutableCharCollection> R collectChar(ByteToCharFunction function, R target)
Returns the targetMutableCharCollectionwith the results of applying the specified function on each element of the source collection.- Since:
- 8.1.
-
collectShort
default <R extends MutableShortCollection> R collectShort(ByteToShortFunction function, R target)
Returns the targetMutableShortCollectionwith the results of applying the specified function on each element of the source collection.- Since:
- 8.1.
-
collectInt
default <R extends MutableIntCollection> R collectInt(ByteToIntFunction function, R target)
Returns the targetMutableIntCollectionwith the results of applying the specified function on each element of the source collection.- Since:
- 8.1.
-
collectFloat
default <R extends MutableFloatCollection> R collectFloat(ByteToFloatFunction function, R target)
Returns the targetMutableFloatCollectionwith the results of applying the specified function on each element of the source collection.- Since:
- 8.1.
-
collectLong
default <R extends MutableLongCollection> R collectLong(ByteToLongFunction function, R target)
Returns the targetMutableLongCollectionwith the results of applying the specified function on each element of the source collection.- Since:
- 8.1.
-
collectDouble
default <R extends MutableDoubleCollection> R collectDouble(ByteToDoubleFunction function, R target)
Returns the targetMutableDoubleCollectionwith the results of applying the specified function on each element of the source collection.- Since:
- 8.1.
-
detectIfNone
byte detectIfNone(BytePredicate predicate, byte ifNone)
-
count
int count(BytePredicate predicate)
Returns a count of the number of elements in the ByteIterable that return true for the specified predicate.
-
anySatisfy
boolean anySatisfy(BytePredicate predicate)
Returns true if any of the elements in the ByteIterable return true for the specified predicate, otherwise returns false.
-
allSatisfy
boolean allSatisfy(BytePredicate predicate)
Returns true if all of the elements in the ByteIterable return true for the specified predicate, otherwise returns false.
-
noneSatisfy
default boolean noneSatisfy(BytePredicate predicate)
Returns true if none of the elements in the ByteIterable return true for the specified predicate, otherwise returns false.
-
toList
MutableByteList toList()
Converts the ByteIterable to a new MutableByteList.
-
toSet
MutableByteSet toSet()
Converts the ByteIterable to a new MutableByteSet.
-
toBag
MutableByteBag toBag()
Converts the ByteIterable to a new MutableByteBag.
-
asLazy
LazyByteIterable asLazy()
Returns a LazyByteIterable adapter wrapping the source ByteIterable.
-
injectInto
<T> T injectInto(T injectedValue, ObjectByteToObjectFunction<? super T,? extends T> function)
-
injectIntoBoolean
default boolean injectIntoBoolean(boolean injectedValue, BooleanByteToBooleanFunction function)Returns the final boolean result of evaluating function using each element of the iterable and the previous evaluation result as the parameters. The injected value is used for the first parameter of the first evaluation, and the current item in the iterable is used as the second parameter.- Since:
- 11.1
-
injectIntoByte
default byte injectIntoByte(byte injectedValue, ByteByteToByteFunction function)Returns the final byte result of evaluating function using each element of the iterable and the previous evaluation result as the parameters. The injected value is used for the first parameter of the first evaluation, and the current item in the iterable is used as the second parameter.- Since:
- 11.1
-
injectIntoChar
default char injectIntoChar(char injectedValue, CharByteToCharFunction function)Returns the final char result of evaluating function using each element of the iterable and the previous evaluation result as the parameters. The injected value is used for the first parameter of the first evaluation, and the current item in the iterable is used as the second parameter.- Since:
- 11.1
-
injectIntoShort
default short injectIntoShort(short injectedValue, ShortByteToShortFunction function)Returns the final short result of evaluating function using each element of the iterable and the previous evaluation result as the parameters. The injected value is used for the first parameter of the first evaluation, and the current item in the iterable is used as the second parameter.- Since:
- 11.1
-
injectIntoInt
default int injectIntoInt(int injectedValue, IntByteToIntFunction function)Returns the final int result of evaluating function using each element of the iterable and the previous evaluation result as the parameters. The injected value is used for the first parameter of the first evaluation, and the current item in the iterable is used as the second parameter.- Since:
- 11.1
-
injectIntoFloat
default float injectIntoFloat(float injectedValue, FloatByteToFloatFunction function)Returns the final float result of evaluating function using each element of the iterable and the previous evaluation result as the parameters. The injected value is used for the first parameter of the first evaluation, and the current item in the iterable is used as the second parameter.- Since:
- 11.1
-
injectIntoLong
default long injectIntoLong(long injectedValue, LongByteToLongFunction function)Returns the final long result of evaluating function using each element of the iterable and the previous evaluation result as the parameters. The injected value is used for the first parameter of the first evaluation, and the current item in the iterable is used as the second parameter.- Since:
- 11.1
-
injectIntoDouble
default double injectIntoDouble(double injectedValue, DoubleByteToDoubleFunction function)Returns the final double result of evaluating function using each element of the iterable and the previous evaluation result as the parameters. The injected value is used for the first parameter of the first evaluation, and the current item in the iterable is used as the second parameter.- Since:
- 11.1
-
reduceIfEmpty
default long reduceIfEmpty(LongByteToLongFunction accumulator, long defaultValue)
- Since:
- 10.0
- See Also:
reduce(LongByteToLongFunction)
-
reduce
default long reduce(LongByteToLongFunction accumulator)
- Since:
- 10.0
- See Also:
RichIterable.reduce(BinaryOperator)
-
chunk
default RichIterable<ByteIterable> chunk(int size)
Partitions elements in fixed size chunks.- Parameters:
size- the number of elements per chunk- Returns:
- A
RichIterablecontainingByteIterables of sizesize, except the last will be truncated if the elements don't divide evenly. - Since:
- 9.2
-
sum
long sum()
-
summaryStatistics
default IntSummaryStatistics summaryStatistics()
- Since:
- 8.0
-
max
byte max()
-
maxIfEmpty
byte maxIfEmpty(byte defaultValue)
-
min
byte min()
-
minIfEmpty
byte minIfEmpty(byte defaultValue)
-
average
double average()
-
averageIfEmpty
default double averageIfEmpty(double defaultValue)
- Since:
- 9.0
-
median
double median()
-
medianIfEmpty
default double medianIfEmpty(double defaultValue)
- Since:
- 9.0
-
toSortedArray
byte[] toSortedArray()
-
toSortedList
MutableByteList toSortedList()
-
toSortedList
default MutableByteList toSortedList(ByteComparator comparator)
Converts the collection to a MutableByteList implementation sorted using the provided comparator.
-
toSortedListBy
default <T> MutableByteList toSortedListBy(ByteToObjectFunction<T> function)
Converts the collection to a MutableByteListImplementation sorted based on the natural order of the key returned byfunction.
-
toSortedListBy
default <T> MutableByteList toSortedListBy(ByteToObjectFunction<T> function, Comparator<? super T> comparator)
Converts the collection to a MutableByteList implementation, which is sorted based on the key returned byfunctionusing the providedcomparator.
-
-