Module de.siegmar.fastcsv

Package de.siegmar.fastcsv.writer

Class CsvWriter

java.lang.Object

de.siegmar.fastcsv.writer.CsvWriter

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

public final class CsvWriter
extends Object
implements Closeable, Flushable

This is the main class for writing CSV data.

Example use:

 try (CsvWriter csv = CsvWriter.builder().build(file)) {
     csv.writeRecord("Hello", "world");
 }

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	CsvWriter.CsvWriterBuilder	This builder is used to create configured instances of CsvWriter.
final class	CsvWriter.CsvWriterRecord	This class is used to write a record field by field.

Method Summary

Modifier and Type	Method	Description
static CsvWriter.CsvWriterBuilder	builder()	Creates a CsvWriter.CsvWriterBuilder instance used to configure and create instances of this class.
void	close()
void	flush()
String	toString()
CsvWriter	writeComment(String comment)	Writes a comment line and new line character(s) at the end.
CsvWriter.CsvWriterRecord	writeRecord()	Starts a new record.
CsvWriter	writeRecord(Iterable<String> values)	Writes a complete line - one or more fields and new line character(s) at the end.
CsvWriter	writeRecord(String... values)	Writes a complete line - one or more fields and new line character(s) at the end.

Methods inherited from class java.lang.Object

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

Method Details

builder

public static CsvWriter.CsvWriterBuilder builder()

Creates a CsvWriter.CsvWriterBuilder instance used to configure and create instances of this class.

Returns:

CsvWriterBuilder instance with default settings.

writeRecord

public CsvWriter writeRecord(Iterable<String> values)

Writes a complete line - one or more fields and new line character(s) at the end.

Parameters:

values - the fields to write (null values are handled as empty strings, if not configured otherwise (QuoteStrategies.EMPTY)).

Returns:

This CsvWriter.

Throws:

UncheckedIOException - if a write-error occurs

IllegalStateException - if a record is already started (by calling writeRecord()) and not ended

See Also:

• writeRecord(String...)

writeRecord

public CsvWriter writeRecord(String... values)

Writes a complete line - one or more fields and new line character(s) at the end.

Parameters:

values - the fields to write (null values are handled as empty strings, if not configured otherwise (QuoteStrategies.EMPTY))

Returns:

This CsvWriter.

Throws:

UncheckedIOException - if a write-error occurs

IllegalStateException - if a record is already started (by calling writeRecord()) and not ended

See Also:

• writeRecord(Iterable)

writeRecord

public CsvWriter.CsvWriterRecord writeRecord()

Starts a new record.

This method is used to write a record field by field. The record is ended by calling CsvWriter.CsvWriterRecord.endRecord().

Returns:

CsvWriterRecord instance to write fields to.

Throws:

IllegalStateException - if a record is already started

See Also:

• writeRecord(String...)
• writeRecord(Iterable)

writeComment

public CsvWriter writeComment(String comment)

Writes a comment line and new line character(s) at the end.

Note that comments are not part of the CSV standard and may not be supported by all readers.

Parameters:

comment - the comment to write. The comment character (configured by CsvWriter.CsvWriterBuilder.commentCharacter(char)) is automatically prepended. Empty or null values results in a line only consisting of the comment character. If the argument comment contains line break characters (CR, LF), multiple comment lines will be written, terminated with the line break character configured by CsvWriter.CsvWriterBuilder.lineDelimiter(LineDelimiter).

Returns:

This CsvWriter.

Throws:

UncheckedIOException - if a write-error occurs

IllegalStateException - if a record is already started (by calling writeRecord()) and not ended

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException

flush

public void flush()
           throws IOException

Specified by:

flush in interface Flushable

Throws:

IOException

toString

public String toString()

Overrides:

toString in class Object