Struct dcsv::Reader

pub struct Reader { /* private fields */ }

Csv Reader

User can set various reader option to configure a reading behaviour. Reader’s options are not dropped after a read but persists for reader’s lifetime.

Usage

use dcsv::Reader;

let csv_value = "a,b,c
1,2,3";

let data = Reader::new()
   .trim(true)
   .ignore_empty_row(true)
   .has_header(true)
   .data_from_stream(csv_value.as_bytes());

Implementations

impl Reader

pub fn new() -> Self

pub fn with_option(self, option: ReaderOption) -> Self

Build with reader option

pub fn consume_dquote(self, tv: bool) -> Self

Consumes double quote in csv file

pub fn ignore_empty_row(self, tv: bool) -> Self

Ignore empty rows

This prevents reader from panicking on empty row.

pub fn trim(self, tv: bool) -> Self

Trim all read values

pub fn allow_invalid_string(self, allow: bool) -> Self

Allow invalid string while parsing csv values

pub fn has_header(self, has_header: bool) -> Self

Whether csv data has header or not

pub fn custom_header<T: AsRef<str>>(self, headers: &[T]) -> Self

Set custom header

This will override “has_header” option and create header from given values.

pub fn clear_reader_option(&mut self)

Clear reader option and set to default

pub fn use_delimiter(self, delimiter: char) -> Self

Use given delimiter instead of default one : “,”.

pub fn use_space_delimiter(self, tv: bool) -> Self

Use space delimiter

pub fn use_line_delimiter(self, delimiter: char) -> Self

Use given line delimiter instead of default one : “\n, \r\n”.

Only default state will detect both “\n” and “\r\n”. If you set “\n” manually, “\r\n” will be ignored.

pub fn data_from_stream( &mut self, csv_stream: impl BufRead ) -> DcsvResult<VirtualData>

Read csv value from buf read stream

This returns read value as virtual data struct

pub fn array_from_stream( &mut self, csv_stream: impl BufRead ) -> DcsvResult<VirtualArray>

Read csv value from buf read stream

This returns read value as virtual array struct

Trait Implementations

impl Default for Reader

fn default() -> Self

Returns the “default value” for a type.