org.apache.lucene.util.packed
Class AppendingDeltaPackedLongBuffer

java.lang.Object
  org.apache.lucene.util.packed.AppendingDeltaPackedLongBuffer

public final class AppendingDeltaPackedLongBuffer
extends Object

Utility class to buffer a list of signed longs in memory. This class only supports appending and is optimized for the case where values are close to each other.

NOTE: This API is for internal purposes only and might change in incompatible ways in the next release.

Constructor Summary

AppendingDeltaPackedLongBuffer()
Create an AppendingDeltaPackedLongBuffer with initialPageCount=16, pageSize=1024 and acceptableOverheadRatio=PackedInts.DEFAULT

AppendingDeltaPackedLongBuffer(float acceptableOverheadRatio)
Create an AppendingDeltaPackedLongBuffer with initialPageCount=16, pageSize=1024

AppendingDeltaPackedLongBuffer(int initialPageCount, int pageSize, float acceptableOverheadRatio)
Create AppendingDeltaPackedLongBuffer

Method Summary

void	add(long l) Append a value to this buffer.
void	freeze() Pack all pending values in this buffer.
long	get(long index) Get a value from this buffer.
int	get(long index, long[] arr, int off, int len) Bulk get: read at least one and at most len longs starting from index into arr[off:off+len] and return the actual number of values that have been read.
org.apache.lucene.util.packed.AbstractAppendingLongBuffer.Iterator	iterator() Return an iterator over the values of this buffer.
long	ramBytesUsed() Return the number of bytes used by this instance.
long	size() Get the number of values that have been added to the buffer.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AppendingDeltaPackedLongBuffer

public AppendingDeltaPackedLongBuffer(int initialPageCount,
                                      int pageSize,
                                      float acceptableOverheadRatio)

Create AppendingDeltaPackedLongBuffer

Parameters:

initialPageCount - the initial number of pages

pageSize - the size of a single page

acceptableOverheadRatio - an acceptable overhead ratio per value

AppendingDeltaPackedLongBuffer

public AppendingDeltaPackedLongBuffer()

Create an AppendingDeltaPackedLongBuffer with initialPageCount=16, pageSize=1024 and acceptableOverheadRatio=PackedInts.DEFAULT

AppendingDeltaPackedLongBuffer

public AppendingDeltaPackedLongBuffer(float acceptableOverheadRatio)

Create an AppendingDeltaPackedLongBuffer with initialPageCount=16, pageSize=1024

Method Detail

ramBytesUsed

public long ramBytesUsed()

Return the number of bytes used by this instance.

size

public final long size()

Get the number of values that have been added to the buffer.

add

public final void add(long l)

Append a value to this buffer.

get

public final long get(long index)

Get a value from this buffer.

get

public final int get(long index,
                     long[] arr,
                     int off,
                     int len)

Bulk get: read at least one and at most len longs starting from index into arr[off:off+len] and return the actual number of values that have been read.

iterator

public org.apache.lucene.util.packed.AbstractAppendingLongBuffer.Iterator iterator()

Return an iterator over the values of this buffer.

freeze

public void freeze()

Pack all pending values in this buffer. Subsequent calls to add(long) will fail.