Class FileLinesByteArrayCollection
- java.lang.Object
-
- java.util.AbstractCollection<byte[]>
-
- it.unimi.dsi.big.io.FileLinesByteArrayCollection
-
- All Implemented Interfaces:
it.unimi.dsi.fastutil.Size64
,java.lang.Iterable<byte[]>
,java.util.Collection<byte[]>
@Deprecated public class FileLinesByteArrayCollection extends java.util.AbstractCollection<byte[]> implements it.unimi.dsi.fastutil.Size64
Deprecated.Please useFileLinesByteArrayIterable
instead; thezipped
option of this class can be simulated by passing aGZIPInputStream
as decompressor.A wrapper exhibiting the lines of a file as aCollection
of byte arrays.An instance of this class allows to access the lines of a file as a
Collection
of byte arrays. Reading is performed usingFastBufferedInputStream.readLine(byte[], EnumSet)
, and follows the rules defined therein. No decoding is performed.Using direct access is strongly discouraged (it will require a full scan of the file), but the
iterator()
can be fruitfully used to scan the file, and can be called any number of times, as it opens an independent input stream at each call. For the same reason, the returned iterator type (FileLinesCollection.FileLinesIterator
) isCloseable
, and should be closed after usage.Using a suitable constructor, it is possible to specify that the file is compressed in
gzip
format (in this case, it will be opened using aGZIPInputStream
).Note that the first call to
size64()
will require a full file scan.- Since:
- 2.2.8
- Author:
- Sebastiano Vigna
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
FileLinesByteArrayCollection.FileLinesIterator
Deprecated.Please useFileLinesByteArrayIterable.iterator(java.io.InputStream, Class, EnumSet)
; thezipped
option of this class can be simulated by passing aGZIPInputStream
as decompressor.
-
Constructor Summary
Constructors Constructor Description FileLinesByteArrayCollection(java.lang.CharSequence filename)
Deprecated.Creates a byte-array file-lines collection for the specified filename, using both CR and LF as line terminators.FileLinesByteArrayCollection(java.lang.CharSequence filename, boolean zipped)
Deprecated.Creates a byte-array file-lines collection for the specified filename, optionally assuming that the file is compressed usinggzip
format, using both CR and LF as line terminators.FileLinesByteArrayCollection(java.lang.CharSequence filename, boolean zipped, java.util.EnumSet<it.unimi.dsi.fastutil.io.FastBufferedInputStream.LineTerminator> terminators)
Deprecated.Creates a byte-array file-lines collection for the specified filename, optionally assuming that the file is compressed usinggzip
format, using the specified line terminators.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description it.unimi.dsi.fastutil.objects.ObjectBigList<byte[]>
allLines()
Deprecated.Returns all lines of the file wrapped by this file-lines collection.FileLinesByteArrayCollection.FileLinesIterator
iterator()
Deprecated.int
size()
Deprecated.Please usesize64()
instead.long
size64()
Deprecated.java.lang.Object[]
toArray()
Deprecated.<T> T[]
toArray(T[] a)
Deprecated.java.lang.String
toString()
Deprecated.-
Methods inherited from class java.util.AbstractCollection
add, addAll, clear, contains, containsAll, isEmpty, remove, removeAll, retainAll
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
-
-
-
Constructor Detail
-
FileLinesByteArrayCollection
public FileLinesByteArrayCollection(java.lang.CharSequence filename)
Deprecated.Creates a byte-array file-lines collection for the specified filename, using both CR and LF as line terminators.- Parameters:
filename
- a filename.
-
FileLinesByteArrayCollection
public FileLinesByteArrayCollection(java.lang.CharSequence filename, boolean zipped)
Deprecated.Creates a byte-array file-lines collection for the specified filename, optionally assuming that the file is compressed usinggzip
format, using both CR and LF as line terminators.- Parameters:
filename
- a filename.zipped
- whetherfilename
is zipped.
-
FileLinesByteArrayCollection
public FileLinesByteArrayCollection(java.lang.CharSequence filename, boolean zipped, java.util.EnumSet<it.unimi.dsi.fastutil.io.FastBufferedInputStream.LineTerminator> terminators)
Deprecated.Creates a byte-array file-lines collection for the specified filename, optionally assuming that the file is compressed usinggzip
format, using the specified line terminators.- Parameters:
filename
- a filename.zipped
- whetherfilename
is zipped.terminators
- line terminators for the underlyingFastBufferedInputStream
.
-
-
Method Detail
-
iterator
public FileLinesByteArrayCollection.FileLinesIterator iterator()
Deprecated.- Specified by:
iterator
in interfacejava.util.Collection<byte[]>
- Specified by:
iterator
in interfacejava.lang.Iterable<byte[]>
- Specified by:
iterator
in classjava.util.AbstractCollection<byte[]>
-
size
@Deprecated public int size()
Deprecated.Please usesize64()
instead.- Specified by:
size
in interfacejava.util.Collection<byte[]>
- Specified by:
size
in interfaceit.unimi.dsi.fastutil.Size64
- Specified by:
size
in classjava.util.AbstractCollection<byte[]>
-
size64
public long size64()
Deprecated.- Specified by:
size64
in interfaceit.unimi.dsi.fastutil.Size64
-
allLines
public it.unimi.dsi.fastutil.objects.ObjectBigList<byte[]> allLines()
Deprecated.Returns all lines of the file wrapped by this file-lines collection.- Returns:
- all lines of the file wrapped by this file-lines collection.
-
toArray
@Deprecated public java.lang.Object[] toArray()
Deprecated.- Specified by:
toArray
in interfacejava.util.Collection<byte[]>
- Overrides:
toArray
in classjava.util.AbstractCollection<byte[]>
-
toArray
@Deprecated public <T> T[] toArray(T[] a)
Deprecated.- Specified by:
toArray
in interfacejava.util.Collection<byte[]>
- Overrides:
toArray
in classjava.util.AbstractCollection<byte[]>
-
toString
public java.lang.String toString()
Deprecated.- Overrides:
toString
in classjava.util.AbstractCollection<byte[]>
-
-