class util::CsvInStream

sys::Obj
  sys::InStream
    util::CsvInStream

@Js

Source

CsvInStream is used to read delimiter-separated values as specified by RFC 4180. Format details:

  • rows are delimited by a newline
  • cells are separated by delimiter char
  • cells may be quoted with " character
  • quoted cells may contain the delimiter
  • quoted cells may contain newlines (always normalized to "\n")
  • quoted cells must escape " with ""
  • the trim flag trims leading/trailing whitespace from non-quoted cells (note that RFC 4180 specifies that whitespace is significant)

Also see CsvOutStream.

delimiter

Int delimiter := 44

Source

Delimiter character; defaults to comma.

eachRow

Void eachRow(|Str[]| f)

Source

Iterate through all the lines parsing each one into delimited-separated strings and calling the given callback functions. The input stream is guaranteed to be closed upon completion.

make

new make(InStream in)

Source

Wrap the underlying input stream.

readAllRows

Str[][] readAllRows()

Source

Read the entire table of rows into memory. The input stream is guaranteed to be closed upon completion.

readRow

virtual Str[]? readRow()

Source

Read the next line as a row of delimiter-separated strings. Return null if at end of stream.

trim

Bool trim := true

Source

Configures whether unqualified whitespace around a cell is automatically trimmed. If a field is enclosed by quotes then it is never trimmed.