Struct CsvParser 

pub struct CsvParser<'de> { /* private fields */ }

CSV parser that emits FormatParser events.

CSV is parsed as a struct where each comma-separated field corresponds to a struct field in definition order. The format does not support nested structures or arrays.

Unlike fully self-describing formats (JSON), CSV is positional:

• Fields are identified by column order, not names
• The parser uses hint_struct_fields to know how many fields to expect
• Each field emits an OrderedField event followed by a Scalar value

Implementations

impl<'de> CsvParser<'de>

pub fn new(input: &'de str) -> Self

Create a new CSV parser for a single row.

Trait Implementations

impl<'de> FormatParser<'de> for CsvParser<'de>

type Error = CsvError

Parser-specific error type.

type Probe<'a> = CsvProbe where Self: 'a

Evidence cursor type produced by FormatParser::begin_probe.

fn next_event(&mut self) -> Result<Option<ParseEvent<'de>>, Self::Error>

Read the next parse event, or None if the input is exhausted.

fn peek_event(&mut self) -> Result<Option<ParseEvent<'de>>, Self::Error>

Peek at the next event without consuming it, or None if at EOF.

fn skip_value(&mut self) -> Result<(), Self::Error>

Skip the current value (for unknown fields, etc.).

fn begin_probe(&mut self) -> Result<Self::Probe<'_>, Self::Error>

Begin evidence collection for untagged-enum resolution.

fn is_self_describing(&self) -> bool

Returns true if this format is self-describing.

fn hint_struct_fields(&mut self, num_fields: usize)

Hint to the parser that a struct with the given number of fields is expected.

fn hint_scalar_type(&mut self, hint: ScalarTypeHint)

Hint to the parser what scalar type is expected next.

fn capture_raw(&mut self) -> Result<Option<&'de str>, Self::Error>

Capture the raw representation of the current value without parsing it.

fn raw_capture_shape(&self) -> Option<&'static Shape>

Returns the shape of the format’s raw capture type (e.g., RawJson::SHAPE).

fn hint_sequence(&mut self)

Hint to the parser that a sequence (array/Vec) is expected.

fn hint_byte_sequence(&mut self) -> bool

Hint to the parser that a byte sequence (Vec<u8>, &[u8], etc.) is expected.

fn hint_array(&mut self, _len: usize)

Hint to the parser that a fixed-size array is expected.

fn hint_option(&mut self)

Hint to the parser that an Option<T> is expected.

fn hint_map(&mut self)

Hint to the parser that a map is expected.

fn hint_dynamic_value(&mut self)

Hint to the parser that a dynamic value is expected.

fn hint_enum(&mut self, _variants: &[EnumVariantHint])

Hint to the parser that an enum is expected, providing variant information.

fn hint_opaque_scalar( &mut self, _type_identifier: &'static str, _shape: &'static Shape, ) -> bool

Hint to the parser that an opaque scalar type is expected.

fn current_span(&self) -> Option<Span>

Returns the source span of the most recently consumed event.

fn format_namespace(&self) -> Option<&'static str>

Returns the format namespace for format-specific proxy resolution.