Top Description Fields Constructors Methods
org.HdrHistogram

public Class DoubleLogarithmicIterator

extends Object
implements Iterator<DoubleHistogramIterationValue>
Class Inheritance
All Implemented Interfaces
java.util.Iterator
Imports
java.util.Iterator

Used for iterating through DoubleHistogram values values in logarithmically increasing levels. The iteration is performed in steps that start at valueUnitsInFirstBucket and increase exponentially according to logBase, terminating when all recorded histogram values are exhausted. Note that each iteration "bucket" includes values up to and including the next bucket boundary value.

Field Summary

Modifier and TypeField and Description
pack-priv DoubleHistogram
private final LogarithmicIterator
private final DoubleHistogramIterationValue

Constructor Summary

AccessConstructor and Description
public
DoubleLogarithmicIterator(final DoubleHistogram
The histogram this iterator will operate on
histogram
,
final double
the size (in value units) of the first value bucket step
valueUnitsInFirstBucket
,
final double
the multiplier by which the bucket size is expanded in each iteration step.
logBase
)

Method Summary

Modifier and TypeMethod and Description
public boolean
hasNext()

Implements java.util.Iterator.hasNext.

Returns true if the iteration has more elements.
public DoubleHistogramIterationValue
next()

Implements java.util.Iterator.next.

Returns the next element in the iteration.
public void
remove()

Overrides default java.util.Iterator.remove.

Removes from the underlying collection the last element returned by this iterator (optional operation).
public void
reset(final double
the size (in value units) of the first value bucket step
valueUnitsInFirstBucket
,
final double
the multiplier by which the bucket size is expanded in each iteration step.
logBase
)

Reset iterator for re-use in a fresh iteration over the same histogram data set.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

histogramback to summary
pack-priv DoubleHistogram histogram
integerLogarithmicIteratorback to summary
private final LogarithmicIterator integerLogarithmicIterator
iterationValueback to summary
private final DoubleHistogramIterationValue iterationValue

Constructor Detail

DoubleLogarithmicIteratorback to summary
public DoubleLogarithmicIterator(final DoubleHistogram histogram, final double valueUnitsInFirstBucket, final double logBase)
Parameters
histogram:DoubleHistogram

The histogram this iterator will operate on

valueUnitsInFirstBucket:double

the size (in value units) of the first value bucket step

logBase:double

the multiplier by which the bucket size is expanded in each iteration step.

Method Detail

hasNextback to summary
public boolean hasNext()

Implements java.util.Iterator.hasNext.

Doc from java.util.Iterator.hasNext.

Returns true if the iteration has more elements. (In other words, returns true if next would return an element rather than throwing an exception.)

Returns:boolean

true if the iteration has more elements

Annotations
@Override
nextback to summary
public DoubleHistogramIterationValue next()

Implements java.util.Iterator.next.

Doc from java.util.Iterator.next.

Returns the next element in the iteration.

Returns:DoubleHistogramIterationValue

the next element in the iteration

Annotations
@Override
removeback to summary
public void remove()

Overrides default java.util.Iterator.remove.

Doc from java.util.Iterator.remove.

Removes from the underlying collection the last element returned by this iterator (optional operation). This method can be called only once per call to next.

The behavior of an iterator is unspecified if the underlying collection is modified while the iteration is in progress in any way other than by calling this method, unless an overriding class has specified a concurrent modification policy.

The behavior of an iterator is unspecified if this method is called after a call to the forEachRemaining method.

Annotations
@Override
resetback to summary
public void reset(final double valueUnitsInFirstBucket, final double logBase)

Reset iterator for re-use in a fresh iteration over the same histogram data set.

Parameters
valueUnitsInFirstBucket:double

the size (in value units) of the first value bucket step

logBase:double

the multiplier by which the bucket size is expanded in each iteration step.