Class EliasFanoMonotoneBigLongBigList
- All Implemented Interfaces:
it.unimi.dsi.fastutil.BigList<Long>, it.unimi.dsi.fastutil.longs.LongBigList, it.unimi.dsi.fastutil.longs.LongCollection, it.unimi.dsi.fastutil.longs.LongIterable, it.unimi.dsi.fastutil.longs.LongStack, it.unimi.dsi.fastutil.Size64, it.unimi.dsi.fastutil.Stack<Long>, Serializable, Comparable<it.unimi.dsi.fastutil.BigList<? extends Long>>, Iterable<Long>, Collection<Long>
EliasFanoMonotoneLongBigList, but slightly slower and without size limitations.
Instances of this class can be memory mapped using MappedEliasFanoMonotoneLongBigList.
- See Also:
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionclassA list iterator over the values of thisEliasFanoMonotoneBigLongBigList.Nested classes/interfaces inherited from class it.unimi.dsi.fastutil.longs.AbstractLongBigList
it.unimi.dsi.fastutil.longs.AbstractLongBigList.LongRandomAccessSubList, it.unimi.dsi.fastutil.longs.AbstractLongBigList.LongSubList -
Field Summary
FieldsModifier and TypeFieldDescriptionprotected final intThe number of lower bits.protected final longThe length of the sequence.protected long[][]The list of lower bits of each element, stored explicitly in a big array.protected final longThe mask for the lower bits.protected final SimpleBigSelectThe select structure used to extract the upper bits.protected long[][]The upper bits, stored as unary gaps. -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotectedEliasFanoMonotoneBigLongBigList(long[] a, it.unimi.dsi.fastutil.longs.LongIterator iterator) Creates an Elias–Fano representation of the values returned by an iterator, given that the overall number of elements and an upper bound are provided, too.protectedEliasFanoMonotoneBigLongBigList(long length, int l, long[][] upperBits, long[][] lowerBits, SimpleBigSelect selectUpper) EliasFanoMonotoneBigLongBigList(long n, long upperBound, it.unimi.dsi.fastutil.bytes.ByteIterator iterator) Creates an Elias–Fano representation of the values returned by an iterator, given that the overall number of elements and an upper bound are provided, too.EliasFanoMonotoneBigLongBigList(long n, long upperBound, it.unimi.dsi.fastutil.ints.IntIterator iterator) Creates an Elias–Fano representation of the values returned by an iterator, given that the overall number of elements and an upper bound are provided, too.EliasFanoMonotoneBigLongBigList(long n, long upperBound, it.unimi.dsi.fastutil.longs.LongIterator iterator) Creates an Elias–Fano representation of the values returned by an iterator, given that the overall number of elements and an upper bound are provided, too.EliasFanoMonotoneBigLongBigList(long n, long upperBound, it.unimi.dsi.fastutil.shorts.ShortIterator iterator) Creates an Elias–Fano representation of the values returned by an iterator, given that the overall number of elements and an upper bound are provided, too.EliasFanoMonotoneBigLongBigList(it.unimi.dsi.fastutil.bytes.ByteIterable list) Creates an Elias–Fano representation of the values returned by the given iterable object.EliasFanoMonotoneBigLongBigList(it.unimi.dsi.fastutil.ints.IntIterable list) Creates an Elias–Fano representation of the values returned by the given iterable object.EliasFanoMonotoneBigLongBigList(it.unimi.dsi.fastutil.longs.LongIterable list) Creates an Elias–Fano representation of the values returned by the given iterable object.EliasFanoMonotoneBigLongBigList(it.unimi.dsi.fastutil.shorts.ShortIterable list) Creates an Elias–Fano representation of the values returned by the given iterable object. -
Method Summary
Modifier and TypeMethodDescriptionvoidDumps this list's lower bits in native order so that it can be used withMappedEliasFanoMonotoneLongBigList.voidDumps this list's lower bits so that it can be used withMappedEliasFanoMonotoneLongBigList.long[]get(long index, long[] dest) Extracts a number of consecutive entries into a given array.long[]get(long index, long[] dest, int offset, int length) Extracts a number of consecutive entries into a given array fragment.longgetDelta(long index) Returns the difference between two consecutive elements of the sequence.longgetLong(long index) Returns the element at the specified position.iterator()Returns a list iterator over the values of thisEliasFanoMonotoneBigLongBigList.Returns a list iterator over the values of thisEliasFanoMonotoneBigLongBigList.listIterator(long from) Returns a list iterator over the values of thisEliasFanoMonotoneBigLongBigList.longnumBits()longsize64()Methods inherited from class it.unimi.dsi.fastutil.longs.AbstractLongBigList
add, add, add, addAll, addAll, addAll, addAll, addElements, addElements, clear, compareTo, contains, ensureIndex, ensureRestrictedIndex, equals, forEach, get, getElements, hashCode, indexOf, indexOf, lastIndexOf, lastIndexOf, peek, peekLong, pop, popLong, push, push, rem, remove, removeElements, removeLong, set, set, setElements, size, size, subList, top, topLong, toStringMethods inherited from class it.unimi.dsi.fastutil.longs.AbstractLongCollection
add, contains, containsAll, containsAll, forEach, remove, removeAll, removeAll, removeIf, retainAll, retainAll, toArray, toLongArray, toLongArrayMethods inherited from class AbstractCollection
isEmpty, toArray, toArrayMethods inherited from interface Collection
containsAll, isEmpty, removeAll, retainAll, toArray, toArray, toArrayMethods inherited from interface it.unimi.dsi.fastutil.longs.LongBigList
addAll, addAll, addAll, addAll, getElements, setElements, setElements, spliteratorMethods inherited from interface it.unimi.dsi.fastutil.longs.LongCollection
add, contains, containsAll, longIterator, longParallelStream, longSpliterator, longStream, parallelStream, remove, removeAll, removeIf, removeIf, removeIf, retainAll, stream, toArray, toLongArray, toLongArrayMethods inherited from interface it.unimi.dsi.fastutil.longs.LongIterable
forEach, forEachMethods inherited from interface it.unimi.dsi.fastutil.Stack
isEmpty
-
Field Details
-
length
protected final long lengthThe length of the sequence. -
l
protected final int lThe number of lower bits. -
upperBits
protected transient long[][] upperBitsThe upper bits, stored as unary gaps. -
lowerBits
protected long[][] lowerBitsThe list of lower bits of each element, stored explicitly in a big array. -
selectUpper
The select structure used to extract the upper bits. -
lowerBitsMask
protected final long lowerBitsMaskThe mask for the lower bits.
-
-
Constructor Details
-
EliasFanoMonotoneBigLongBigList
protected EliasFanoMonotoneBigLongBigList(long length, int l, long[][] upperBits, long[][] lowerBits, SimpleBigSelect selectUpper) -
EliasFanoMonotoneBigLongBigList
public EliasFanoMonotoneBigLongBigList(it.unimi.dsi.fastutil.ints.IntIterable list) Creates an Elias–Fano representation of the values returned by the given iterable object.- Parameters:
list- an iterable object returning nondecreasing natural numbers.
-
EliasFanoMonotoneBigLongBigList
public EliasFanoMonotoneBigLongBigList(it.unimi.dsi.fastutil.shorts.ShortIterable list) Creates an Elias–Fano representation of the values returned by the given iterable object.- Parameters:
list- an iterable object returning nondecreasing natural numbers.
-
EliasFanoMonotoneBigLongBigList
public EliasFanoMonotoneBigLongBigList(it.unimi.dsi.fastutil.bytes.ByteIterable list) Creates an Elias–Fano representation of the values returned by the given iterable object.- Parameters:
list- an iterable object returning nondecreasing natural numbers.
-
EliasFanoMonotoneBigLongBigList
public EliasFanoMonotoneBigLongBigList(it.unimi.dsi.fastutil.longs.LongIterable list) Creates an Elias–Fano representation of the values returned by the given iterable object.- Parameters:
list- an iterable object returning nondecreasing natural numbers.
-
EliasFanoMonotoneBigLongBigList
public EliasFanoMonotoneBigLongBigList(long n, long upperBound, it.unimi.dsi.fastutil.bytes.ByteIterator iterator) Creates an Elias–Fano representation of the values returned by an iterator, given that the overall number of elements and an upper bound are provided, too.This constructor is particularly useful if the elements of the iterator are provided by some sequential source.
- Parameters:
n- the number of elements returned byiterator.upperBound- a strict upper bound to the values returned byiterator(note that it used to be non-strict).iterator- an iterator returning nondecreasing natural numbers.
-
EliasFanoMonotoneBigLongBigList
public EliasFanoMonotoneBigLongBigList(long n, long upperBound, it.unimi.dsi.fastutil.shorts.ShortIterator iterator) Creates an Elias–Fano representation of the values returned by an iterator, given that the overall number of elements and an upper bound are provided, too.This constructor is particularly useful if the elements of the iterator are provided by some sequential source.
- Parameters:
n- the number of elements returned byiterator.upperBound- a strict upper bound to the values returned byiterator(note that it used to be non-strict).iterator- an iterator returning nondecreasing natural numbers.
-
EliasFanoMonotoneBigLongBigList
public EliasFanoMonotoneBigLongBigList(long n, long upperBound, it.unimi.dsi.fastutil.ints.IntIterator iterator) Creates an Elias–Fano representation of the values returned by an iterator, given that the overall number of elements and an upper bound are provided, too.This constructor is particularly useful if the elements of the iterator are provided by some sequential source.
- Parameters:
n- the number of elements returned byiterator.upperBound- a strict upper bound to the values returned byiterator(note that it used to be non-strict).iterator- an iterator returning nondecreasing natural numbers.
-
EliasFanoMonotoneBigLongBigList
public EliasFanoMonotoneBigLongBigList(long n, long upperBound, it.unimi.dsi.fastutil.longs.LongIterator iterator) Creates an Elias–Fano representation of the values returned by an iterator, given that the overall number of elements and an upper bound are provided, too.This constructor is particularly useful if the elements of the iterator are provided by some sequential source.
- Parameters:
n- the number of elements returned byiterator.upperBound- a strict upper bound to the values returned byiterator(note that it used to be non-strict).iterator- an iterator returning nondecreasing natural numbers.
-
EliasFanoMonotoneBigLongBigList
protected EliasFanoMonotoneBigLongBigList(long[] a, it.unimi.dsi.fastutil.longs.LongIterator iterator) Creates an Elias–Fano representation of the values returned by an iterator, given that the overall number of elements and an upper bound are provided, too.This constructor is used only internally, to work around the usual problems caused by the obligation to call
this()before anything else.- Parameters:
a- an array containing the number of elements returned byiteratorand a strict upper bound to the values returned byiterator(note that it used to be non-strict).iterator- an iterator returning nondecreasing natural numbers.
-
-
Method Details
-
numBits
public long numBits() -
getLong
public long getLong(long index) Returns the element at the specified position.- Specified by:
getLongin interfaceit.unimi.dsi.fastutil.longs.LongBigList- Parameters:
index- a position in the list.- Returns:
- the element at the specified position; if
indexis out of bounds, behavior is undefined.
-
getDelta
public long getDelta(long index) Returns the difference between two consecutive elements of the sequence.- Parameters:
index- the index of an element (smaller thensize64()- 1).- Returns:
- the difference between the element of position
index + 1and that of positionindex; ifindexis out of bounds, behavior is undefined. - See Also:
-
get
public long[] get(long index, long[] dest, int offset, int length) Extracts a number of consecutive entries into a given array fragment.- Parameters:
index- the index of the first entry returned.dest- the destination array; it will be filled withlengthconsecutive entries starting at positionoffset; must be of length greater thanoffset.offset- the first position written indest.length- the number of elements written indeststarting atoffset.- Returns:
dest; if the arguments are out of bounds, behavior is undefined.- See Also:
-
get
public long[] get(long index, long[] dest) Extracts a number of consecutive entries into a given array.- Parameters:
index- the index of the first entry returned.dest- the destination array, of nonzero length; it will be filled with consecutive entries.- Returns:
dest; ifindexis out of bounds ordesthas length zero, behavior is undefined.- See Also:
-
listIterator
Returns a list iterator over the values of thisEliasFanoMonotoneBigLongBigList.Forward iteration will be faster than iterated calls to
getLong(). Backward iteration is available, but it will perform similarly togetLong().- Specified by:
listIteratorin interfaceit.unimi.dsi.fastutil.BigList<Long>- Specified by:
listIteratorin interfaceit.unimi.dsi.fastutil.longs.LongBigList- Overrides:
listIteratorin classit.unimi.dsi.fastutil.longs.AbstractLongBigList- Parameters:
from- the starting position in the sequence.- Returns:
- a list iterator over the values of this
EliasFanoMonotoneBigLongBigList. - See Also:
-
listIterator
Returns a list iterator over the values of thisEliasFanoMonotoneBigLongBigList.Forward iteration will be faster than iterated calls to
getLong(). Backward iteration is available, but it will perform similarly togetLong().- Specified by:
listIteratorin interfaceit.unimi.dsi.fastutil.BigList<Long>- Specified by:
listIteratorin interfaceit.unimi.dsi.fastutil.longs.LongBigList- Overrides:
listIteratorin classit.unimi.dsi.fastutil.longs.AbstractLongBigList- Returns:
- a list iterator over the values of this
EliasFanoMonotoneBigLongBigList. - See Also:
-
iterator
Returns a list iterator over the values of thisEliasFanoMonotoneBigLongBigList.Forward iteration will be faster than iterated calls to
getLong(). Backward iteration is available, but it will perform similarly togetLong().- Specified by:
iteratorin interfaceCollection<Long>- Specified by:
iteratorin interfaceIterable<Long>- Specified by:
iteratorin interfaceit.unimi.dsi.fastutil.longs.LongBigList- Specified by:
iteratorin interfaceit.unimi.dsi.fastutil.longs.LongCollection- Specified by:
iteratorin interfaceit.unimi.dsi.fastutil.longs.LongIterable- Overrides:
iteratorin classit.unimi.dsi.fastutil.longs.AbstractLongBigList- Returns:
- a list iterator over the values of this
EliasFanoMonotoneBigLongBigList. - See Also:
-
size64
public long size64()- Specified by:
size64in interfaceit.unimi.dsi.fastutil.Size64
-
dump
Dumps this list's lower bits in native order so that it can be used withMappedEliasFanoMonotoneLongBigList.- Parameters:
basename- the basename of the generated files.- Throws:
IOException
-
dump
Dumps this list's lower bits so that it can be used withMappedEliasFanoMonotoneLongBigList.Two files will be generated: a serialized object with extension
MappedEliasFanoMonotoneLongBigList.OBJECT_EXTENSIONand a list of longs in the specified byte order with extensionMappedEliasFanoMonotoneLongBigList.LOWER_BITS_EXTENSION.- Parameters:
basename- the basename of the generated files.byteOrder- the desired byte order.- Throws:
IOException
-