diff --git a/src/java/org/apache/commons/csv/CSVParser.java b/src/java/org/apache/commons/csv/CSVParser.java index cfbf1070..46d58e00 100644 --- a/src/java/org/apache/commons/csv/CSVParser.java +++ b/src/java/org/apache/commons/csv/CSVParser.java @@ -16,31 +16,27 @@ */ package org.apache.commons.csv; -import java.io.IOException; -import java.io.InputStream; -import java.io.InputStreamReader; -import java.io.Reader; +import java.io.*; import java.util.ArrayList; /** - * Parses cvs files according to the specified configuration. + * Parses CSV files according to the specified configuration. * - * Because CSV appears in many different dialects the parser supports many - * configuration settings. One of the most popular CSV format as supported - * by the M$ corporation (excel-spreadsheets) are supported out-of-the-box - * by the corresponding strategy setter (see {@link #setExcelStrategy()}). + * Because CSV appears in many different dialects, the parser supports many + * configuration settings by allowing the specification of a {@link CSVStrategy}. * - *

Parsing of a csv-string having ';' as separator:

+ *

Parsing of a csv-string having tabs as separators, + * '"' as an optional value encapsulator, and comments starting with '#':

*
  *  String[][] data = 
- *      (new CSVParser(new StringReader("a;b\nc;d"),';')).getAllValues();
+ *   (new CSVParser(new StringReader("a\tb\nc\td"), new CSVStrategy('\t','"','#'))).getAllValues();
  * 
* - *

The API allows chained method calls, if you like this coding style:

+ *

Parsing of a csv-string in Excel CSV format

*
- *  String[][] data = (new CSVParser(new StringReader("a;b\nc;d"),';'))
- *      .setExcelStrategy().setIgnoreEmptyLines(true).getAllValues();
+ *  String[][] data =
+ *   (new CSVParser(new StringReader("a;b\nc;d"), CSVStrategy.EXCEL_STRATEGY)).getAllValues();
  * 
* *