net.sf.csv4j

Class CSVParser

java.lang.Object

net.sf.csv4j.CSVParser

public class CSVParser
extends Object

Parses CSV lines of text. Options are available to choose the

• delimiter
• whether to trim whitespace from the tokens

Notes: Line with trailing comma will result in an empty string field

Attempts to follow this suggestion from RFC4180: Implementors should "be conservative in what you do, be liberal in what you accept from others" (RFC 793) when processing CSV files.

Since:

1.0

Author:

Shawn Boyce

See Also:

Comma Separated Values on Wikipedia, RFC 4180

Constructor Summary

Constructors

Constructor and Description
CSVParser() Constructor with default delimiter (,) and trimFields (true).
CSVParser(char delimiter, boolean trimFields) Constructs the parser with specified options

Method Summary

Modifier and Type	Method and Description
long	countFields(String line) Assumes this is one line of CSV text
String	toJSon(String line, long lineNumber) Assumes this is one line of CSV text
List<String>	tokenize(String line) Assumes this is one line of CSV text

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CSVParser

public CSVParser()

Constructor with default delimiter (,) and trimFields (true).

CSVParser

public CSVParser(char delimiter,
                 boolean trimFields)

Constructs the parser with specified options

Parameters:

delimiter - field separator character (e.g. comma, tab, vertical bar / pipe, space)

trimFields - indicates if fields are to be trimmed or not

Method Detail

tokenize

public List<String> tokenize(String line)
                      throws ParseException

Assumes this is one line of CSV text

Parameters:

line - line of text to parse

Returns:

list of tokens/fields; never returns null

Throws:

ParseException - if

1. carriage return/newline found outside of a double quote, and
2. terminating double quote not found

countFields

public long countFields(String line)
                 throws ParseException

Assumes this is one line of CSV text

Parameters:

line - line of text to parse

Returns:

number of fields

Throws:

ParseException - if

1. carriage return/newline found outside of a double quote, and
2. terminating double quote not found

toJSon

public String toJSon(String line,
                     long lineNumber)
              throws ParseException

Assumes this is one line of CSV text

Parameters:

line - line of text to parse

Returns:

list of tokens/fields; never returns null

Throws:

ParseException - if

1. carriage return/newline found outside of a double quote, and
2. terminating double quote not found