CsvReader
Alternate constructor for just using default separator which is comma.
Alternate constructor for CsvReader providing string input and optionally specifying separator character.
Alternate constructor for CsvReader providing string input and optionally specifying separator character.
This alternate constructor exists mainly to make tests and code examples shorter.
Create a new reader while specifying the separator character.
Create a new reader while specifying the separator character.
Input can be string or java.io.Reader. Be mindful of the character set.
Optional non-default separator character
(Changed in version 2.8.0) collect has changed. The previous behavior can be reproduced with toSeq.
Optional non-default separator character
This method converts this reader into exception based error handling, which may be useful in smaller applications that don't expect errors in input.
This method converts this reader into exception based error handling, which may be useful in smaller applications that don't expect errors in input.
A RuntimeException will be thrown when error is encountered. After this
the iterator is considered exhausted after the error.
After being wrapped using this method, the reader produces simple StringCells instead of Scala's Either.
Note that the stream will be left open in this situation.
This class is part of the lower level API for processing CSV data. This is a CSV parser that produces the data through the scala.collection.Iterator trait. The data is read into a sequence of StringCell instances. StringCells can be written back to disk with CsvWriter.
This class does parsing in streaming fashion ie. you should be able to handle files larger than what can fit in RAM, though this has not been tested yet. The actual parsing is delegated to CsvReaderInternal. This class just implements the Scala
Iteratorinterface on top of CsvReaderInternal.Error handling
If an error is encountered in the input a CsvReaderError will be returned as the
LeftofEither. After this the iterator is exhausted andhasNextwill return false. Note that the input stream will be left open in this situation. Ifnextis called whenhasNextisfalse, aNoSuchElementExceptionwill be thrown as usual. See the method throwOnError for a shortcut to enable exception based error handling.Code example
This example code will pick the second column from the
csvDataand print thetoStringof eachCellfrom that column. Note the use ofthrowOnErrorto bypass theEithernormally returned by the reader.A note on closing the input stream. The java.io.Reader is closed only if the CSV data exhausted. In the case of an error and in the case of stopping to call the
readmethod before the input ends it is the responsibility of the caller to close the stream.TableReader for a friendlier non streaming API.