Skip to main content

Row

Struct Row 

Source
pub struct Row { /* private fields */ }

Implementations§

Source§

impl Row

Source

pub fn error(&self) -> Option<&ReadError>

The parse error for this row, if any.

Source

pub fn len(&self) -> usize

Number of fields parsed for this row.

Fields are still counted when the row carries an error.

Source

pub fn is_empty(&self) -> bool

Source

pub fn get(&self, index: usize) -> Option<Result<&str, ReadError>>

Returns the field at index, or None if there is no such field.

Consistent with to_vec and iter: if the row carries a parse error, every in-range index yields Err. Only an out-of-range index yields None.

Source

pub fn to_vec(&self) -> Result<Vec<&str>, ReadError>

Returns all fields as &str, or the row’s parse error.

Source

pub fn iter(&self) -> Fields<'_> ⓘ

Iterates over the fields, yielding the row’s parse error for each field when the row is malformed.

Source§

impl Row

Source

pub fn deserialize<T>(&self) -> Result<T, ReadError>

Deserialize this row into a T.

Headers must have been set on the parent Reader via parse_headers or set_headers before calling this method. Struct fields are matched by column name.

A struct field with no matching column deserializes from an empty string. A field whose column exists but is absent from this row (short or ragged row), or whose bytes are not valid UTF-8, is reported as an error rather than being silently turned into an empty string.

§Errors

Returns ReadError with kind Deserialize if headers have not been set, if the headers contain duplicate names (which makes name-based lookup ambiguous), or if deserialization fails (type mismatch, unknown field, missing column data, invalid UTF-8, etc.).

§Example
use csv::Reader;
use serde::Deserialize;

#[derive(Deserialize)]
struct Record { name: String, age: u32 }

let mut reader = Reader::new(std::io::Cursor::new(b"name,age\nAlice,30\n"));
reader.parse_headers()?;
for row in reader.rows() {
    let rec: Record = row.deserialize()?;
    println!("{} is {}", rec.name, rec.age);
}

Trait Implementations§

Source§

impl Debug for Row

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl !RefUnwindSafe for Row

§

impl !UnwindSafe for Row

§

impl Freeze for Row

§

impl Send for Row

§

impl Sync for Row

§

impl Unpin for Row

§

impl UnsafeUnpin for Row

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.