package csv

Import Path
	encoding/csv (on golang.org and go.dev)

Dependency Relation
	imports 8 packages, and imported by 0 packages

Involved Source Files
	d-> reader.go
	    writer.go

Exported Type Names

type ParseError (struct) A ParseError is returned for parsing errors. Line numbers are 1-indexed and columns are 0-indexed. // Column (rune index) where the error occurred // The actual error // Line where the error occurred // Line where the record starts (*T) Error() string (*T) Unwrap() error *T : error
type Reader (struct) A Reader reads records from a CSV-encoded file. As returned by NewReader, a Reader expects input conforming to RFC 4180. The exported fields can be changed to customize the details before the first call to Read or ReadAll. The Reader converts all \r\n sequences in its input to plain \n, including in multiline field values, so that the returned data does not depend on which line-ending convention an input file uses. Comma is the field delimiter. It is set to comma (',') by NewReader. Comma must be a valid rune and must not be \r, \n, or the Unicode replacement character (0xFFFD). Comment, if not 0, is the comment character. Lines beginning with the Comment character without preceding whitespace are ignored. With leading whitespace the Comment character becomes part of the field, even if TrimLeadingSpace is true. Comment must be a valid rune and must not be \r, \n, or the Unicode replacement character (0xFFFD). It must also not be equal to Comma. FieldsPerRecord is the number of expected fields per record. If FieldsPerRecord is positive, Read requires each record to have the given number of fields. If FieldsPerRecord is 0, Read sets it to the number of fields in the first record, so that future records must have the same field count. If FieldsPerRecord is negative, no check is made and records may have a variable number of fields. If LazyQuotes is true, a quote may appear in an unquoted field and a non-doubled quote may appear in a quoted field. ReuseRecord controls whether calls to Read may return a slice sharing the backing array of the previous call's returned slice for performance. By default, each call to Read returns newly allocated memory owned by the caller. // Deprecated: No longer used. If TrimLeadingSpace is true, leading white space in a field is ignored. This is done even if the field delimiter, Comma, is white space. Read reads one record (a slice of fields) from r. If the record has an unexpected number of fields, Read returns the record along with the error ErrFieldCount. Except for that case, Read always returns either a non-nil record or a non-nil error, but not both. If there is no data left to be read, Read returns nil, io.EOF. If ReuseRecord is true, the returned slice may be shared between multiple calls to Read. ReadAll reads all the remaining records from r. Each record is a slice of fields. A successful call returns err == nil, not err == io.EOF. Because ReadAll is defined to read until EOF, it does not treat end of file as an error to be reported. func NewReader(r io.Reader) *Reader
type Writer (struct) A Writer writes records using CSV encoding. As returned by NewWriter, a Writer writes records terminated by a newline and uses ',' as the field delimiter. The exported fields can be changed to customize the details before the first call to Write or WriteAll. Comma is the field delimiter. If UseCRLF is true, the Writer ends each output line with \r\n instead of \n. The writes of individual records are buffered. After all data has been written, the client should call the Flush method to guarantee all data has been forwarded to the underlying io.Writer. Any errors that occurred should be checked by calling the Error method. // Field delimiter (set to ',' by NewWriter) // True to use \r\n as the line terminator Error reports any error that has occurred during a previous Write or Flush. Flush writes any buffered data to the underlying io.Writer. To check if an error occurred during the Flush, call Error. Write writes a single CSV record to w along with any necessary quoting. A record is a slice of strings with each string being one field. Writes are buffered, so Flush must eventually be called to ensure that the record is written to the underlying io.Writer. WriteAll writes multiple CSV records to w using Write and then calls Flush, returning any error from the Flush. *T : net/http.Flusher func NewWriter(w io.Writer) *Writer
Exported Values
var ErrBareQuote error These are the errors that can be returned in ParseError.Err.
var ErrFieldCount error These are the errors that can be returned in ParseError.Err.
var ErrQuote error These are the errors that can be returned in ParseError.Err.
var ErrTrailingComma error // Deprecated: No longer used. These are the errors that can be returned in ParseError.Err.
func NewReader(r io.Reader) *Reader NewReader returns a new Reader that reads from r.
func NewWriter(w io.Writer) *Writer NewWriter returns a new Writer that writes to w.