Package it.unimi.dsi.big.io

Class FileLinesByteArrayCollection

java.lang.Object

java.util.AbstractCollection<byte[]>

it.unimi.dsi.big.io.FileLinesByteArrayCollection

All Implemented Interfaces:

it.unimi.dsi.fastutil.Size64, Iterable<byte[]>, Collection<byte[]>

@Deprecated
public class FileLinesByteArrayCollection
extends AbstractCollection<byte[]>
implements it.unimi.dsi.fastutil.Size64

Deprecated.

Please use FileLinesByteArrayIterable instead; the zipped option of this class can be simulated by passing a GZIPInputStream as decompressor.

A wrapper exhibiting the lines of a file as a Collection 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 using FastBufferedInputStream.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) is Closeable, 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 a GZIPInputStream).

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 final class	FileLinesByteArrayCollection.FileLinesIterator	Deprecated. Please use FileLinesByteArrayIterable.iterator(java.io.InputStream, Class, EnumSet); the zipped option of this class can be simulated by passing a GZIPInputStream as decompressor.

Constructor Summary

Constructors

Constructor	Description
FileLinesByteArrayCollection(CharSequence filename)	Deprecated. Creates a byte-array file-lines collection for the specified filename, using both CR and LF as line terminators.
FileLinesByteArrayCollection(CharSequence filename, boolean zipped)	Deprecated. Creates a byte-array file-lines collection for the specified filename, optionally assuming that the file is compressed using gzip format, using both CR and LF as line terminators.
FileLinesByteArrayCollection(CharSequence filename, boolean zipped, 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 using gzip format, using the specified line terminators.

Method Summary

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 use size64() instead.
long	size64()	Deprecated.
Object[]	toArray()	Deprecated.
<T> T[]	toArray(T[] a)	Deprecated.
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

Methods inherited from interface java.util.Collection

equals, hashCode, parallelStream, removeIf, spliterator, stream, toArray

Methods inherited from interface java.lang.Iterable

forEach

Constructor Details

FileLinesByteArrayCollection

public FileLinesByteArrayCollection(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(CharSequence filename,
 boolean zipped)

Deprecated.

Creates a byte-array file-lines collection for the specified filename, optionally assuming that the file is compressed using gzip format, using both CR and LF as line terminators.

Parameters:

filename - a filename.

zipped - whether filename is zipped.

FileLinesByteArrayCollection

public FileLinesByteArrayCollection(CharSequence filename,
 boolean zipped,
 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 using gzip format, using the specified line terminators.

Parameters:

filename - a filename.

zipped - whether filename is zipped.

terminators - line terminators for the underlying FastBufferedInputStream.

Method Details

iterator

public FileLinesByteArrayCollection.FileLinesIterator iterator()

Deprecated.

Specified by:

iterator in interface Collection<byte[]>

Specified by:

iterator in interface Iterable<byte[]>

Specified by:

iterator in class AbstractCollection<byte[]>

size

@Deprecated
public int size()

Deprecated.

Please use size64() instead.

Specified by:

size in interface Collection<byte[]>

Specified by:

size in interface it.unimi.dsi.fastutil.Size64

Specified by:

size in class AbstractCollection<byte[]>

size64

public long size64()

Deprecated.

Specified by:

size64 in interface it.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 Object[] toArray()

Deprecated.

Specified by:

toArray in interface Collection<byte[]>

Overrides:

toArray in class AbstractCollection<byte[]>

toArray

@Deprecated
public <T> T[] toArray(T[] a)

Deprecated.

Specified by:

toArray in interface Collection<byte[]>

Overrides:

toArray in class AbstractCollection<byte[]>

toString

public String toString()

Deprecated.

Overrides:

toString in class AbstractCollection<byte[]>