com.aspc.remote.memory

Class LargeLongArray

java.lang.Object

com.aspc.remote.memory.LargeLongArray

public class LargeLongArray
extends java.lang.Object

Handle very large long arrays.
THREAD MODE: SINGLE THREADED

Since:

21 Nov 2015

Author:

Nigel Leck

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LargeLongArray.Builder The long array builder.
static interface	LargeLongArray.SanityArrayCounter record when a new array is created.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_SEGMENT_SIZE The default number of longs per segment.

Method Summary

Modifier and Type	Method and Description
void	append(long value)
static LargeLongArray.Builder	factory()
static LargeLongArray.Builder	factory(long[] rows) The factory to create a new Large Long Array.
static LargeLongArray.Builder	factory(long[][] data) The factory to create a new Large Long Array.
long	get(long pos) Get the value at this position.
boolean	remove(long value) remove a value
long[][]	repack() Repack this array.
int	replace(long from, long to)
long	set(long pos, long value) Set the value at this position.
long	size() The size of this long array.
long[][]	sort() Sort the passed in data.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_SEGMENT_SIZE

public static final int DEFAULT_SEGMENT_SIZE

The default number of longs per segment.

Method Detail

factory

@CheckReturnValue
 @Nonnull
public static LargeLongArray.Builder factory(@Nonnull
                                                                         long[][] data)

The factory to create a new Large Long Array.

Parameters:

data - the data.

Returns:

the factory

factory

@CheckReturnValue
 @Nonnull
public static LargeLongArray.Builder factory(@Nullable
                                                                         long[] rows)

The factory to create a new Large Long Array.

Parameters:

rows - the data.

Returns:

the factory

factory

@CheckReturnValue
 @Nonnull
public static LargeLongArray.Builder factory()

sort

@Nonnull
 @CheckReturnValue
public long[][] sort()

Sort the passed in data. The data must be unique and non zero. A new array is created ONLY if needed.

Returns:

the sorted data.

append

public void append(long value)

remove

public boolean remove(long value)

remove a value

Parameters:

value - to remove

Returns:

true if found

size

@CheckReturnValue
 @Nonnegative
public long size()

The size of this long array.

Returns:

the size.

repack

@Nonnull
 @CheckReturnValue
public long[][] repack()

Repack this array. This will always result in NEW array being created UNLESS outputShared is marked as OFF in the builder.

Returns:

the new array

get

@CheckReturnValue
public long get(@Nonnegative
                                  long pos)

Get the value at this position.

Parameters:

pos - the position

Returns:

the value.

replace

public int replace(long from,
                   long to)

set

public long set(@Nonnegative
                long pos,
                long value)

Set the value at this position.

Parameters:

pos - the position

value - the value to set

Returns:

the previous value.