it.unimi.dsi.fastutil.io
Class TextIO

java.lang.Object
  extended byit.unimi.dsi.fastutil.io.TextIO

public class TextIO
extends Object

Provides static methods to perform easily textual I/O.

This class fills a gap in the Java API: a natural operation on sequences of primitive elements is to load or store them in textual form. This format makes files humanly readable.

For each primitive type, this class provides methods that read elements from a BufferedReader or from a filename (which will be opened using a buffer of BUFFER_SIZE bytes) into an array. Analogously, there are methods that store the content of an array (fragment) or the elements returned by an iterator to a PrintStream or to a given filename.

Finally, there are useful wrapper methods that exhibit a file as a type-specific iterator.

Note that, contrarily to the binary case, there is no way to load an array from a file. You can easily work around the problem as follows:

 array = IntIterators.unwrap( TextIO.asIntIterator("foo") );
 

Since:
4.4

Field Summary
static int BUFFER_SIZE
          The size of the buffer used for all I/O on files.
 
Method Summary
static ByteIterator asByteIterator(BufferedReader reader)
          Wraps the given buffered reader into an iterator.
static ByteIterator asByteIterator(CharSequence filename)
          Wraps the given filename into an iterator.
static DoubleIterator asDoubleIterator(BufferedReader reader)
          Wraps the given buffered reader into an iterator.
static DoubleIterator asDoubleIterator(CharSequence filename)
          Wraps the given filename into an iterator.
static FloatIterator asFloatIterator(BufferedReader reader)
          Wraps the given buffered reader into an iterator.
static FloatIterator asFloatIterator(CharSequence filename)
          Wraps the given filename into an iterator.
static IntIterator asIntIterator(BufferedReader reader)
          Wraps the given buffered reader into an iterator.
static IntIterator asIntIterator(CharSequence filename)
          Wraps the given filename into an iterator.
static LongIterator asLongIterator(BufferedReader reader)
          Wraps the given buffered reader into an iterator.
static LongIterator asLongIterator(CharSequence filename)
          Wraps the given filename into an iterator.
static ShortIterator asShortIterator(BufferedReader reader)
          Wraps the given buffered reader into an iterator.
static ShortIterator asShortIterator(CharSequence filename)
          Wraps the given filename into an iterator.
static int loadBytes(BufferedReader reader, byte[] array)
          Loads elements from a given buffered reader, storing them in a given array.
static int loadBytes(BufferedReader reader, byte[] array, int offset, int length)
          Loads elements from a given fast buffered reader, storing them in a given array fragment.
static int loadBytes(CharSequence filename, byte[] array)
          Loads elements from a given filename, storing them in a given array.
static int loadBytes(CharSequence filename, byte[] array, int offset, int length)
          Loads elements from a given filename, storing them in a given array fragment.
static int loadDoubles(BufferedReader reader, double[] array)
          Loads elements from a given buffered reader, storing them in a given array.
static int loadDoubles(BufferedReader reader, double[] array, int offset, int length)
          Loads elements from a given fast buffered reader, storing them in a given array fragment.
static int loadDoubles(CharSequence filename, double[] array)
          Loads elements from a given filename, storing them in a given array.
static int loadDoubles(CharSequence filename, double[] array, int offset, int length)
          Loads elements from a given filename, storing them in a given array fragment.
static int loadFloats(BufferedReader reader, float[] array)
          Loads elements from a given buffered reader, storing them in a given array.
static int loadFloats(BufferedReader reader, float[] array, int offset, int length)
          Loads elements from a given fast buffered reader, storing them in a given array fragment.
static int loadFloats(CharSequence filename, float[] array)
          Loads elements from a given filename, storing them in a given array.
static int loadFloats(CharSequence filename, float[] array, int offset, int length)
          Loads elements from a given filename, storing them in a given array fragment.
static int loadInts(BufferedReader reader, int[] array)
          Loads elements from a given buffered reader, storing them in a given array.
static int loadInts(BufferedReader reader, int[] array, int offset, int length)
          Loads elements from a given fast buffered reader, storing them in a given array fragment.
static int loadInts(CharSequence filename, int[] array)
          Loads elements from a given filename, storing them in a given array.
static int loadInts(CharSequence filename, int[] array, int offset, int length)
          Loads elements from a given filename, storing them in a given array fragment.
static int loadLongs(BufferedReader reader, long[] array)
          Loads elements from a given buffered reader, storing them in a given array.
static int loadLongs(BufferedReader reader, long[] array, int offset, int length)
          Loads elements from a given fast buffered reader, storing them in a given array fragment.
static int loadLongs(CharSequence filename, long[] array)
          Loads elements from a given filename, storing them in a given array.
static int loadLongs(CharSequence filename, long[] array, int offset, int length)
          Loads elements from a given filename, storing them in a given array fragment.
static int loadShorts(BufferedReader reader, short[] array)
          Loads elements from a given buffered reader, storing them in a given array.
static int loadShorts(BufferedReader reader, short[] array, int offset, int length)
          Loads elements from a given fast buffered reader, storing them in a given array fragment.
static int loadShorts(CharSequence filename, short[] array)
          Loads elements from a given filename, storing them in a given array.
static int loadShorts(CharSequence filename, short[] array, int offset, int length)
          Loads elements from a given filename, storing them in a given array fragment.
static void storeBytes(byte[] array, CharSequence filename)
          Stores an array to a given filename.
static void storeBytes(byte[] array, int offset, int length, CharSequence filename)
          Stores an array fragment to a given filename.
static void storeBytes(byte[] array, int offset, int length, PrintStream stream)
          Stores an array fragment to a given print stream.
static void storeBytes(byte[] array, PrintStream stream)
          Stores an array to a given print stream.
static void storeBytes(ByteIterator i, CharSequence filename)
          Stores the element returned by an iterator to a given filename.
static void storeBytes(ByteIterator i, PrintStream stream)
          Stores the element returned by an iterator to a given print stream.
static void storeDoubles(double[] array, CharSequence filename)
          Stores an array to a given filename.
static void storeDoubles(double[] array, int offset, int length, CharSequence filename)
          Stores an array fragment to a given filename.
static void storeDoubles(double[] array, int offset, int length, PrintStream stream)
          Stores an array fragment to a given print stream.
static void storeDoubles(double[] array, PrintStream stream)
          Stores an array to a given print stream.
static void storeDoubles(DoubleIterator i, CharSequence filename)
          Stores the element returned by an iterator to a given filename.
static void storeDoubles(DoubleIterator i, PrintStream stream)
          Stores the element returned by an iterator to a given print stream.
static void storeFloats(float[] array, CharSequence filename)
          Stores an array to a given filename.
static void storeFloats(float[] array, int offset, int length, CharSequence filename)
          Stores an array fragment to a given filename.
static void storeFloats(float[] array, int offset, int length, PrintStream stream)
          Stores an array fragment to a given print stream.
static void storeFloats(float[] array, PrintStream stream)
          Stores an array to a given print stream.
static void storeFloats(FloatIterator i, CharSequence filename)
          Stores the element returned by an iterator to a given filename.
static void storeFloats(FloatIterator i, PrintStream stream)
          Stores the element returned by an iterator to a given print stream.
static void storeInts(int[] array, CharSequence filename)
          Stores an array to a given filename.
static void storeInts(int[] array, int offset, int length, CharSequence filename)
          Stores an array fragment to a given filename.
static void storeInts(int[] array, int offset, int length, PrintStream stream)
          Stores an array fragment to a given print stream.
static void storeInts(int[] array, PrintStream stream)
          Stores an array to a given print stream.
static void storeInts(IntIterator i, CharSequence filename)
          Stores the element returned by an iterator to a given filename.
static void storeInts(IntIterator i, PrintStream stream)
          Stores the element returned by an iterator to a given print stream.
static void storeLongs(long[] array, CharSequence filename)
          Stores an array to a given filename.
static void storeLongs(long[] array, int offset, int length, CharSequence filename)
          Stores an array fragment to a given filename.
static void storeLongs(long[] array, int offset, int length, PrintStream stream)
          Stores an array fragment to a given print stream.
static void storeLongs(long[] array, PrintStream stream)
          Stores an array to a given print stream.
static void storeLongs(LongIterator i, CharSequence filename)
          Stores the element returned by an iterator to a given filename.
static void storeLongs(LongIterator i, PrintStream stream)
          Stores the element returned by an iterator to a given print stream.
static void storeShorts(short[] array, CharSequence filename)
          Stores an array to a given filename.
static void storeShorts(short[] array, int offset, int length, CharSequence filename)
          Stores an array fragment to a given filename.
static void storeShorts(short[] array, int offset, int length, PrintStream stream)
          Stores an array fragment to a given print stream.
static void storeShorts(short[] array, PrintStream stream)
          Stores an array to a given print stream.
static void storeShorts(ShortIterator i, CharSequence filename)
          Stores the element returned by an iterator to a given filename.
static void storeShorts(ShortIterator i, PrintStream stream)
          Stores the element returned by an iterator to a given print stream.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

BUFFER_SIZE

public static final int BUFFER_SIZE
The size of the buffer used for all I/O on files.

See Also:
Constant Field Values
Method Detail

loadBytes

public static int loadBytes(BufferedReader reader,
                            byte[] array,
                            int offset,
                            int length)
                     throws IOException
Loads elements from a given fast buffered reader, storing them in a given array fragment.

Parameters:
reader - a buffered reader.
array - an array which will be filled with data from reader.
offset - the index of the first element of array to be filled.
length - the number of elements of array to be filled.
Returns:
the number of elements actually read from reader (it might be less than length if reader ends).
Throws:
IOException

loadBytes

public static int loadBytes(BufferedReader reader,
                            byte[] array)
                     throws IOException
Loads elements from a given buffered reader, storing them in a given array.

Parameters:
reader - a buffered reader.
array - an array which will be filled with data from reader.
Returns:
the number of elements actually read from reader (it might be less than the array length if reader ends).
Throws:
IOException

loadBytes

public static int loadBytes(CharSequence filename,
                            byte[] array,
                            int offset,
                            int length)
                     throws IOException
Loads elements from a given filename, storing them in a given array fragment.

Parameters:
filename - a file name.
array - an array which will be filled with data from the specified file.
offset - the index of the first element of array to be filled.
length - the number of elements of array to be filled.
Returns:
the number of elements actually read from the given file (it might be less than length if the file is too short).
Throws:
IOException

loadBytes

public static int loadBytes(CharSequence filename,
                            byte[] array)
                     throws IOException
Loads elements from a given filename, storing them in a given array.

Parameters:
filename - a file name.
array - an array which will be filled with data from the specified file.
Returns:
the number of elements actually read from the given file (it might be less than the array length if the file is too short).
Throws:
IOException

storeBytes

public static void storeBytes(byte[] array,
                              int offset,
                              int length,
                              PrintStream stream)
                       throws IOException
Stores an array fragment to a given print stream.

Parameters:
array - an array whose elements will be written to stream.
offset - the index of the first element of array to be written.
length - the number of elements of array to be written.
stream - a print stream.
Throws:
IOException

storeBytes

public static void storeBytes(byte[] array,
                              PrintStream stream)
                       throws IOException
Stores an array to a given print stream.

Parameters:
array - an array whose elements will be written to stream.
stream - a print stream.
Throws:
IOException

storeBytes

public static void storeBytes(byte[] array,
                              int offset,
                              int length,
                              CharSequence filename)
                       throws IOException
Stores an array fragment to a given filename.

Parameters:
array - an array whose elements will be written to filename.
offset - the index of the first element of array to be written.
length - the number of elements of array to be written.
filename - a file name.
Throws:
IOException

storeBytes

public static void storeBytes(byte[] array,
                              CharSequence filename)
                       throws IOException
Stores an array to a given filename.

Parameters:
array - an array whose elements will be written to filename.
filename - a file name.
Throws:
IOException

storeBytes

public static void storeBytes(ByteIterator i,
                              PrintStream stream)
                       throws IOException
Stores the element returned by an iterator to a given print stream.

Parameters:
i - an iterator whose output will be written to stream.
stream - a print stream.
Throws:
IOException

storeBytes

public static void storeBytes(ByteIterator i,
                              CharSequence filename)
                       throws IOException
Stores the element returned by an iterator to a given filename.

Parameters:
i - an iterator whose output will be written to filename.
filename - a file name.
Throws:
IOException

asByteIterator

public static ByteIterator asByteIterator(BufferedReader reader)
                                   throws IOException
Wraps the given buffered reader into an iterator.

Parameters:
reader - a buffered reader.
Throws:
IOException

asByteIterator

public static ByteIterator asByteIterator(CharSequence filename)
                                   throws IOException
Wraps the given filename into an iterator.

Parameters:
filename - a file name.
Throws:
IOException

loadShorts

public static int loadShorts(BufferedReader reader,
                             short[] array,
                             int offset,
                             int length)
                      throws IOException
Loads elements from a given fast buffered reader, storing them in a given array fragment.

Parameters:
reader - a buffered reader.
array - an array which will be filled with data from reader.
offset - the index of the first element of array to be filled.
length - the number of elements of array to be filled.
Returns:
the number of elements actually read from reader (it might be less than length if reader ends).
Throws:
IOException

loadShorts

public static int loadShorts(BufferedReader reader,
                             short[] array)
                      throws IOException
Loads elements from a given buffered reader, storing them in a given array.

Parameters:
reader - a buffered reader.
array - an array which will be filled with data from reader.
Returns:
the number of elements actually read from reader (it might be less than the array length if reader ends).
Throws:
IOException

loadShorts

public static int loadShorts(CharSequence filename,
                             short[] array,
                             int offset,
                             int length)
                      throws IOException
Loads elements from a given filename, storing them in a given array fragment.

Parameters:
filename - a file name.
array - an array which will be filled with data from the specified file.
offset - the index of the first element of array to be filled.
length - the number of elements of array to be filled.
Returns:
the number of elements actually read from the given file (it might be less than length if the file is too short).
Throws:
IOException

loadShorts

public static int loadShorts(CharSequence filename,
                             short[] array)
                      throws IOException
Loads elements from a given filename, storing them in a given array.

Parameters:
filename - a file name.
array - an array which will be filled with data from the specified file.
Returns:
the number of elements actually read from the given file (it might be less than the array length if the file is too short).
Throws:
IOException

storeShorts

public static void storeShorts(short[] array,
                               int offset,
                               int length,
                               PrintStream stream)
                        throws IOException
Stores an array fragment to a given print stream.

Parameters:
array - an array whose elements will be written to stream.
offset - the index of the first element of array to be written.
length - the number of elements of array to be written.
stream - a print stream.
Throws:
IOException

storeShorts

public static void storeShorts(short[] array,
                               PrintStream stream)
                        throws IOException
Stores an array to a given print stream.

Parameters:
array - an array whose elements will be written to stream.
stream - a print stream.
Throws:
IOException

storeShorts

public static void storeShorts(short[] array,
                               int offset,
                               int length,
                               CharSequence filename)
                        throws IOException
Stores an array fragment to a given filename.

Parameters:
array - an array whose elements will be written to filename.
offset - the index of the first element of array to be written.
length - the number of elements of array to be written.
filename - a file name.
Throws:
IOException

storeShorts

public static void storeShorts(short[] array,
                               CharSequence filename)
                        throws IOException
Stores an array to a given filename.

Parameters:
array - an array whose elements will be written to filename.
filename - a file name.
Throws:
IOException

storeShorts

public static void storeShorts(ShortIterator i,
                               PrintStream stream)
                        throws IOException
Stores the element returned by an iterator to a given print stream.

Parameters:
i - an iterator whose output will be written to stream.
stream - a print stream.
Throws:
IOException

storeShorts

public static void storeShorts(ShortIterator i,
                               CharSequence filename)
                        throws IOException
Stores the element returned by an iterator to a given filename.

Parameters:
i - an iterator whose output will be written to filename.
filename - a file name.
Throws:
IOException

asShortIterator

public static ShortIterator asShortIterator(BufferedReader reader)
                                     throws IOException
Wraps the given buffered reader into an iterator.

Parameters:
reader - a buffered reader.
Throws:
IOException

asShortIterator

public static ShortIterator asShortIterator(CharSequence filename)
                                     throws IOException
Wraps the given filename into an iterator.

Parameters:
filename - a file name.
Throws:
IOException

loadInts

public static int loadInts(BufferedReader reader,
                           int[] array,
                           int offset,
                           int length)
                    throws IOException
Loads elements from a given fast buffered reader, storing them in a given array fragment.

Parameters:
reader - a buffered reader.
array - an array which will be filled with data from reader.
offset - the index of the first element of array to be filled.
length - the number of elements of array to be filled.
Returns:
the number of elements actually read from reader (it might be less than length if reader ends).
Throws:
IOException

loadInts

public static int loadInts(BufferedReader reader,
                           int[] array)
                    throws IOException
Loads elements from a given buffered reader, storing them in a given array.

Parameters:
reader - a buffered reader.
array - an array which will be filled with data from reader.
Returns:
the number of elements actually read from reader (it might be less than the array length if reader ends).
Throws:
IOException

loadInts

public static int loadInts(CharSequence filename,
                           int[] array,
                           int offset,
                           int length)
                    throws IOException
Loads elements from a given filename, storing them in a given array fragment.

Parameters:
filename - a file name.
array - an array which will be filled with data from the specified file.
offset - the index of the first element of array to be filled.
length - the number of elements of array to be filled.
Returns:
the number of elements actually read from the given file (it might be less than length if the file is too short).
Throws:
IOException

loadInts

public static int loadInts(CharSequence filename,
                           int[] array)
                    throws IOException
Loads elements from a given filename, storing them in a given array.

Parameters:
filename - a file name.
array - an array which will be filled with data from the specified file.
Returns:
the number of elements actually read from the given file (it might be less than the array length if the file is too short).
Throws:
IOException

storeInts

public static void storeInts(int[] array,
                             int offset,
                             int length,
                             PrintStream stream)
                      throws IOException
Stores an array fragment to a given print stream.

Parameters:
array - an array whose elements will be written to stream.
offset - the index of the first element of array to be written.
length - the number of elements of array to be written.
stream - a print stream.
Throws:
IOException

storeInts

public static void storeInts(int[] array,
                             PrintStream stream)
                      throws IOException
Stores an array to a given print stream.

Parameters:
array - an array whose elements will be written to stream.
stream - a print stream.
Throws:
IOException

storeInts

public static void storeInts(int[] array,
                             int offset,
                             int length,
                             CharSequence filename)
                      throws IOException
Stores an array fragment to a given filename.

Parameters:
array - an array whose elements will be written to filename.
offset - the index of the first element of array to be written.
length - the number of elements of array to be written.
filename - a file name.
Throws:
IOException

storeInts

public static void storeInts(int[] array,
                             CharSequence filename)
                      throws IOException
Stores an array to a given filename.

Parameters:
array - an array whose elements will be written to filename.
filename - a file name.
Throws:
IOException

storeInts

public static void storeInts(IntIterator i,
                             PrintStream stream)
                      throws IOException
Stores the element returned by an iterator to a given print stream.

Parameters:
i - an iterator whose output will be written to stream.
stream - a print stream.
Throws:
IOException

storeInts

public static void storeInts(IntIterator i,
                             CharSequence filename)
                      throws IOException
Stores the element returned by an iterator to a given filename.

Parameters:
i - an iterator whose output will be written to filename.
filename - a file name.
Throws:
IOException

asIntIterator

public static IntIterator asIntIterator(BufferedReader reader)
                                 throws IOException
Wraps the given buffered reader into an iterator.

Parameters:
reader - a buffered reader.
Throws:
IOException

asIntIterator

public static IntIterator asIntIterator(CharSequence filename)
                                 throws IOException
Wraps the given filename into an iterator.

Parameters:
filename - a file name.
Throws:
IOException

loadLongs

public static int loadLongs(BufferedReader reader,
                            long[] array,
                            int offset,
                            int length)
                     throws IOException
Loads elements from a given fast buffered reader, storing them in a given array fragment.

Parameters:
reader - a buffered reader.
array - an array which will be filled with data from reader.
offset - the index of the first element of array to be filled.
length - the number of elements of array to be filled.
Returns:
the number of elements actually read from reader (it might be less than length if reader ends).
Throws:
IOException

loadLongs

public static int loadLongs(BufferedReader reader,
                            long[] array)
                     throws IOException
Loads elements from a given buffered reader, storing them in a given array.

Parameters:
reader - a buffered reader.
array - an array which will be filled with data from reader.
Returns:
the number of elements actually read from reader (it might be less than the array length if reader ends).
Throws:
IOException

loadLongs

public static int loadLongs(CharSequence filename,
                            long[] array,
                            int offset,
                            int length)
                     throws IOException
Loads elements from a given filename, storing them in a given array fragment.

Parameters:
filename - a file name.
array - an array which will be filled with data from the specified file.
offset - the index of the first element of array to be filled.
length - the number of elements of array to be filled.
Returns:
the number of elements actually read from the given file (it might be less than length if the file is too short).
Throws:
IOException

loadLongs

public static int loadLongs(CharSequence filename,
                            long[] array)
                     throws IOException
Loads elements from a given filename, storing them in a given array.

Parameters:
filename - a file name.
array - an array which will be filled with data from the specified file.
Returns:
the number of elements actually read from the given file (it might be less than the array length if the file is too short).
Throws:
IOException

storeLongs

public static void storeLongs(long[] array,
                              int offset,
                              int length,
                              PrintStream stream)
                       throws IOException
Stores an array fragment to a given print stream.

Parameters:
array - an array whose elements will be written to stream.
offset - the index of the first element of array to be written.
length - the number of elements of array to be written.
stream - a print stream.
Throws:
IOException

storeLongs

public static void storeLongs(long[] array,
                              PrintStream stream)
                       throws IOException
Stores an array to a given print stream.

Parameters:
array - an array whose elements will be written to stream.
stream - a print stream.
Throws:
IOException

storeLongs

public static void storeLongs(long[] array,
                              int offset,
                              int length,
                              CharSequence filename)
                       throws IOException
Stores an array fragment to a given filename.

Parameters:
array - an array whose elements will be written to filename.
offset - the index of the first element of array to be written.
length - the number of elements of array to be written.
filename - a file name.
Throws:
IOException

storeLongs

public static void storeLongs(long[] array,
                              CharSequence filename)
                       throws IOException
Stores an array to a given filename.

Parameters:
array - an array whose elements will be written to filename.
filename - a file name.
Throws:
IOException

storeLongs

public static void storeLongs(LongIterator i,
                              PrintStream stream)
                       throws IOException
Stores the element returned by an iterator to a given print stream.

Parameters:
i - an iterator whose output will be written to stream.
stream - a print stream.
Throws:
IOException

storeLongs

public static void storeLongs(LongIterator i,
                              CharSequence filename)
                       throws IOException
Stores the element returned by an iterator to a given filename.

Parameters:
i - an iterator whose output will be written to filename.
filename - a file name.
Throws:
IOException

asLongIterator

public static LongIterator asLongIterator(BufferedReader reader)
                                   throws IOException
Wraps the given buffered reader into an iterator.

Parameters:
reader - a buffered reader.
Throws:
IOException

asLongIterator

public static LongIterator asLongIterator(CharSequence filename)
                                   throws IOException
Wraps the given filename into an iterator.

Parameters:
filename - a file name.
Throws:
IOException

loadFloats

public static int loadFloats(BufferedReader reader,
                             float[] array,
                             int offset,
                             int length)
                      throws IOException
Loads elements from a given fast buffered reader, storing them in a given array fragment.

Parameters:
reader - a buffered reader.
array - an array which will be filled with data from reader.
offset - the index of the first element of array to be filled.
length - the number of elements of array to be filled.
Returns:
the number of elements actually read from reader (it might be less than length if reader ends).
Throws:
IOException

loadFloats

public static int loadFloats(BufferedReader reader,
                             float[] array)
                      throws IOException
Loads elements from a given buffered reader, storing them in a given array.

Parameters:
reader - a buffered reader.
array - an array which will be filled with data from reader.
Returns:
the number of elements actually read from reader (it might be less than the array length if reader ends).
Throws:
IOException

loadFloats

public static int loadFloats(CharSequence filename,
                             float[] array,
                             int offset,
                             int length)
                      throws IOException
Loads elements from a given filename, storing them in a given array fragment.

Parameters:
filename - a file name.
array - an array which will be filled with data from the specified file.
offset - the index of the first element of array to be filled.
length - the number of elements of array to be filled.
Returns:
the number of elements actually read from the given file (it might be less than length if the file is too short).
Throws:
IOException

loadFloats

public static int loadFloats(CharSequence filename,
                             float[] array)
                      throws IOException
Loads elements from a given filename, storing them in a given array.

Parameters:
filename - a file name.
array - an array which will be filled with data from the specified file.
Returns:
the number of elements actually read from the given file (it might be less than the array length if the file is too short).
Throws:
IOException

storeFloats

public static void storeFloats(float[] array,
                               int offset,
                               int length,
                               PrintStream stream)
                        throws IOException
Stores an array fragment to a given print stream.

Parameters:
array - an array whose elements will be written to stream.
offset - the index of the first element of array to be written.
length - the number of elements of array to be written.
stream - a print stream.
Throws:
IOException

storeFloats

public static void storeFloats(float[] array,
                               PrintStream stream)
                        throws IOException
Stores an array to a given print stream.

Parameters:
array - an array whose elements will be written to stream.
stream - a print stream.
Throws:
IOException

storeFloats

public static void storeFloats(float[] array,
                               int offset,
                               int length,
                               CharSequence filename)
                        throws IOException
Stores an array fragment to a given filename.

Parameters:
array - an array whose elements will be written to filename.
offset - the index of the first element of array to be written.
length - the number of elements of array to be written.
filename - a file name.
Throws:
IOException

storeFloats

public static void storeFloats(float[] array,
                               CharSequence filename)
                        throws IOException
Stores an array to a given filename.

Parameters:
array - an array whose elements will be written to filename.
filename - a file name.
Throws:
IOException

storeFloats

public static void storeFloats(FloatIterator i,
                               PrintStream stream)
                        throws IOException
Stores the element returned by an iterator to a given print stream.

Parameters:
i - an iterator whose output will be written to stream.
stream - a print stream.
Throws:
IOException

storeFloats

public static void storeFloats(FloatIterator i,
                               CharSequence filename)
                        throws IOException
Stores the element returned by an iterator to a given filename.

Parameters:
i - an iterator whose output will be written to filename.
filename - a file name.
Throws:
IOException

asFloatIterator

public static FloatIterator asFloatIterator(BufferedReader reader)
                                     throws IOException
Wraps the given buffered reader into an iterator.

Parameters:
reader - a buffered reader.
Throws:
IOException

asFloatIterator

public static FloatIterator asFloatIterator(CharSequence filename)
                                     throws IOException
Wraps the given filename into an iterator.

Parameters:
filename - a file name.
Throws:
IOException

loadDoubles

public static int loadDoubles(BufferedReader reader,
                              double[] array,
                              int offset,
                              int length)
                       throws IOException
Loads elements from a given fast buffered reader, storing them in a given array fragment.

Parameters:
reader - a buffered reader.
array - an array which will be filled with data from reader.
offset - the index of the first element of array to be filled.
length - the number of elements of array to be filled.
Returns:
the number of elements actually read from reader (it might be less than length if reader ends).
Throws:
IOException

loadDoubles

public static int loadDoubles(BufferedReader reader,
                              double[] array)
                       throws IOException
Loads elements from a given buffered reader, storing them in a given array.

Parameters:
reader - a buffered reader.
array - an array which will be filled with data from reader.
Returns:
the number of elements actually read from reader (it might be less than the array length if reader ends).
Throws:
IOException

loadDoubles

public static int loadDoubles(CharSequence filename,
                              double[] array,
                              int offset,
                              int length)
                       throws IOException
Loads elements from a given filename, storing them in a given array fragment.

Parameters:
filename - a file name.
array - an array which will be filled with data from the specified file.
offset - the index of the first element of array to be filled.
length - the number of elements of array to be filled.
Returns:
the number of elements actually read from the given file (it might be less than length if the file is too short).
Throws:
IOException

loadDoubles

public static int loadDoubles(CharSequence filename,
                              double[] array)
                       throws IOException
Loads elements from a given filename, storing them in a given array.

Parameters:
filename - a file name.
array - an array which will be filled with data from the specified file.
Returns:
the number of elements actually read from the given file (it might be less than the array length if the file is too short).
Throws:
IOException

storeDoubles

public static void storeDoubles(double[] array,
                                int offset,
                                int length,
                                PrintStream stream)
                         throws IOException
Stores an array fragment to a given print stream.

Parameters:
array - an array whose elements will be written to stream.
offset - the index of the first element of array to be written.
length - the number of elements of array to be written.
stream - a print stream.
Throws:
IOException

storeDoubles

public static void storeDoubles(double[] array,
                                PrintStream stream)
                         throws IOException
Stores an array to a given print stream.

Parameters:
array - an array whose elements will be written to stream.
stream - a print stream.
Throws:
IOException

storeDoubles

public static void storeDoubles(double[] array,
                                int offset,
                                int length,
                                CharSequence filename)
                         throws IOException
Stores an array fragment to a given filename.

Parameters:
array - an array whose elements will be written to filename.
offset - the index of the first element of array to be written.
length - the number of elements of array to be written.
filename - a file name.
Throws:
IOException

storeDoubles

public static void storeDoubles(double[] array,
                                CharSequence filename)
                         throws IOException
Stores an array to a given filename.

Parameters:
array - an array whose elements will be written to filename.
filename - a file name.
Throws:
IOException

storeDoubles

public static void storeDoubles(DoubleIterator i,
                                PrintStream stream)
                         throws IOException
Stores the element returned by an iterator to a given print stream.

Parameters:
i - an iterator whose output will be written to stream.
stream - a print stream.
Throws:
IOException

storeDoubles

public static void storeDoubles(DoubleIterator i,
                                CharSequence filename)
                         throws IOException
Stores the element returned by an iterator to a given filename.

Parameters:
i - an iterator whose output will be written to filename.
filename - a file name.
Throws:
IOException

asDoubleIterator

public static DoubleIterator asDoubleIterator(BufferedReader reader)
                                       throws IOException
Wraps the given buffered reader into an iterator.

Parameters:
reader - a buffered reader.
Throws:
IOException

asDoubleIterator

public static DoubleIterator asDoubleIterator(CharSequence filename)
                                       throws IOException
Wraps the given filename into an iterator.

Parameters:
filename - a file name.
Throws:
IOException