Package it.unimi.dsi.webgraph
Class LazyIntIterators
- java.lang.Object
-
- it.unimi.dsi.webgraph.LazyIntIterators
-
public class LazyIntIterators extends java.lang.Object
A class providing static methods and objects that do useful things with lazy integer iterators.
-
-
Field Summary
Fields Modifier and Type Field Description static LazyIntIterator
EMPTY_ITERATOR
An empty lazy iterator.
-
Constructor Summary
Constructors Modifier Constructor Description protected
LazyIntIterators()
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static it.unimi.dsi.fastutil.ints.IntIterator
eager(LazyIntIterator lazyIntIterator)
Returns an eagerIntIterator
enumerating the same elements of a given lazy integer iterator.static LazyIntIterator
lazy(it.unimi.dsi.fastutil.ints.IntIterator eagerIntIterator)
Returns aLazyIntIterator
enumerating the same elements of a given eager integer iterator.static int[]
unwrap(LazyIntIterator lazyIntIterator)
Unwraps the elements returned by a lazy iterator into a new array.static int
unwrap(LazyIntIterator lazyIntIterator, int[] array)
Unwraps the elements returned by a lazy iterator into an array.static int
unwrap(LazyIntIterator lazyIntIterator, int[] array, int offset, int length)
Unwraps the elements returned by a lazy iterator into an array fragment.static int[]
unwrapLoosely(LazyIntIterator lazyIntIterator)
Unwraps the elements returned by a lazy iterator into a new array that can contain additional entries set to zero.static LazyIntIterator
wrap(int[] array)
Returns a lazy integer iterator enumerating the elements of an array.static LazyIntIterator
wrap(int[] array, int length)
Returns a lazy integer iterator enumerating the given number of elements of an array.
-
-
-
Field Detail
-
EMPTY_ITERATOR
public static final LazyIntIterator EMPTY_ITERATOR
An empty lazy iterator.
-
-
Method Detail
-
unwrap
public static int unwrap(LazyIntIterator lazyIntIterator, int[] array)
Unwraps the elements returned by a lazy iterator into an array.- Parameters:
lazyIntIterator
- a lazy integer iterator.array
- an array.- Returns:
- the number of elements unwrapped into
array
starting from index 0.
-
unwrap
public static int unwrap(LazyIntIterator lazyIntIterator, int[] array, int offset, int length)
Unwraps the elements returned by a lazy iterator into an array fragment.- Parameters:
lazyIntIterator
- a lazy integer iterator.array
- an array.offset
- the index of the first element otarray
to be used.length
- the maximum number of elements to be unwrapped.- Returns:
- the number of elements unwrapped into
array
starting from indexoffset
.
-
unwrap
public static int[] unwrap(LazyIntIterator lazyIntIterator)
Unwraps the elements returned by a lazy iterator into a new array.If you need the resulting array to contain the elements returned by
lazyIntIterator
, but some more elements set to zero would cause no harm, consider usingunwrapLoosely(LazyIntIterator)
, which usually avoids a final call toIntArrays.trim(int[], int)
.- Parameters:
lazyIntIterator
- a lazy integer iterator.- Returns:
- an array containing the elements returned by
lazyIntIterator
. - See Also:
unwrapLoosely(LazyIntIterator)
-
unwrapLoosely
public static int[] unwrapLoosely(LazyIntIterator lazyIntIterator)
Unwraps the elements returned by a lazy iterator into a new array that can contain additional entries set to zero.If you need the resulting array to contain exactly the elements returned by
lazyIntIterator
, consider usingunwrap(LazyIntIterator)
, but this method avoids a final call toIntArrays.trim(int[], int)
.- Parameters:
lazyIntIterator
- a lazy integer iterator.- Returns:
- an array containing the elements returned by
lazyIntIterator
; note that in general it might contains some final zeroes beyond the elements returned bylazyIntIterator
, so the number of elements actually written intoarray
must be known externally. - See Also:
unwrap(LazyIntIterator)
-
wrap
public static LazyIntIterator wrap(int[] array, int length)
Returns a lazy integer iterator enumerating the given number of elements of an array.- Parameters:
array
- an array.length
- the number of elements to enumerate.- Returns:
- a lazy integer iterator enumerating the first
length
elements ofarray
.
-
wrap
public static LazyIntIterator wrap(int[] array)
Returns a lazy integer iterator enumerating the elements of an array.- Parameters:
array
- an array.- Returns:
- a lazy integer iterator enumerating the elements of
array
.
-
eager
public static it.unimi.dsi.fastutil.ints.IntIterator eager(LazyIntIterator lazyIntIterator)
Returns an eagerIntIterator
enumerating the same elements of a given lazy integer iterator.- Parameters:
lazyIntIterator
- a lazy integer iterator.- Returns:
- an eager
IntIterator
enumerating the same elements oflazyIntIterator
.
-
lazy
public static LazyIntIterator lazy(it.unimi.dsi.fastutil.ints.IntIterator eagerIntIterator)
Returns aLazyIntIterator
enumerating the same elements of a given eager integer iterator.- Parameters:
eagerIntIterator
- an eager integer iterator.- Returns:
- a lazy integer iterator enumerating the same elements of
eagerIntIterator
.
-
-