Struct Span 

pub struct Span {
    pub start: usize,
    pub end: usize,
    pub escaped: bool,
}

Where one field’s bytes are in the buffer it was read from.

A quoted field’s range is what is between its quotes. escaped says a doubled quote or an escaped one is in there, so the bytes are not the value yet and Span::text has to take the escapes out, which is the one case that copies before the value is used.

Fields

start: usize

The first byte of the field.

end: usize

One past the last byte of the field.

escaped: bool

Whether the bytes still hold escapes.

Implementations

impl Span

pub const fn is_empty(self) -> bool

Whether the field is empty, which the reader turns into a null.

A field with an escape in it is never empty once the escape is taken out, since every escape leaves a quote behind, so the range answers for the value.

pub fn raw(self, bytes: &[u8]) -> &[u8]

The bytes of the field as they are in the buffer, escapes and all.

pub fn text(self, bytes: &[u8], dialect: Dialect) -> Cow<'_, str>

The field as text, borrowed from the buffer unless it had an escape or a byte that is not UTF-8 in it.

The bytes that are not UTF-8 become the replacement character, exactly as String::from_utf8_lossy makes them, because that is what record does and the two have to agree.

Trait Implementations

impl Clone for Span

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Span

impl Debug for Span

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

Formats the value using the given formatter.

impl Eq for Span

impl PartialEq for Span

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Span