CSVParser javadoc cleanup (and remove ref to M$ [sic])

git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/sandbox/csv/trunk@483683 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Yonik Seeley 2006-12-07 21:50:05 +00:00
parent 68e75ee16d
commit 87d5f87806
1 changed files with 10 additions and 14 deletions

View File

@ -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}.
*
* <p>Parsing of a csv-string having ';' as separator:</p>
* <p>Parsing of a csv-string having tabs as separators,
* '"' as an optional value encapsulator, and comments starting with '#':</p>
* <pre>
* String[][] data =
* (new CSVParser(new StringReader("a;b\nc;d"),';')).getAllValues();
* (new CSVParser(new StringReader("a\tb\nc\td"), new CSVStrategy('\t','"','#'))).getAllValues();
* </pre>
*
* <p>The API allows chained method calls, if you like this coding style:</p>
* <p>Parsing of a csv-string in Excel CSV format</p>
* <pre>
* 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();
* </pre>
*
* <p>