Interface BinList.Result
- Enclosing interface:
- BinList
public static interface BinList.Result
Accessor for the results of accumulating values in a bit list.
-
Method Summary
Modifier and TypeMethodDescriptioncompact()
Returns a Result instance with behaviour the same as this one, but with implementation optimised for long-term storage.long
Returns the number of bins actually populated.double
getBinValue
(long index) Returns the value that has been accumulated into the given bin index.Returns an iterator over the indices of the populated bins int this result.
-
Method Details
-
getBinValue
double getBinValue(long index) Returns the value that has been accumulated into the given bin index. The value is the result of using this object's Combiner to combine the submitted values. In general, if no values have been submitted to the bin in question, a NaN should be returned. Note: if this result has been produced by aCombiner
, it should generally be multiplied by thebinFactor
before use.- Parameters:
index
- bin index- Returns:
- bin value
-
getBinCount
long getBinCount()Returns the number of bins actually populated. This is the number of values that will be returned byindexIterator()
.- Returns:
- number of non-empty bins
-
indexIterator
Returns an iterator over the indices of the populated bins int this result.- Returns:
- iterator over distinct indices of all the non-empty bins; none of the values will be larger than the BinList's size
-
compact
BinList.Result compact()Returns a Result instance with behaviour the same as this one, but with implementation optimised for long-term storage. If you're only going to iterate over this object's values once, don't call this method, since it will probably iterate over the values anyway if it does anything at all. But if you're going to keep the result around for potentially multiple uses, retaining the output of this method, rather than the original object, may be more efficient on memory.- Returns:
- compacted result with the same content as this; may return this object
-