Struct sise::Parser

pub struct Parser<'a> { /* fields omitted */ }

Parser that decodes a SISE file from memory.

Example

use sise::Reader as _;
let data = b"(test (1 2 3))";
let mut parser = sise::Parser::new(data);
assert_eq!(parser.read().unwrap().kind, sise::ReadItemKind::ListBeginning);
assert_eq!(parser.read().unwrap().kind, sise::ReadItemKind::Atom("test"));
assert_eq!(parser.read().unwrap().kind, sise::ReadItemKind::ListBeginning);
assert_eq!(parser.read().unwrap().kind, sise::ReadItemKind::Atom("1"));
assert_eq!(parser.read().unwrap().kind, sise::ReadItemKind::Atom("2"));
assert_eq!(parser.read().unwrap().kind, sise::ReadItemKind::Atom("3"));
assert_eq!(parser.read().unwrap().kind, sise::ReadItemKind::ListEnding);
assert_eq!(parser.read().unwrap().kind, sise::ReadItemKind::ListEnding);
parser.finish().unwrap();

Methods

impl<'a> Parser<'a>

pub fn new(data: &'a [u8]) -> Self

Trait Implementations

impl<'a> Reader for Parser<'a>

type Error = ParseError

The error type that may be produced while reading.

type String = &'a str

A type that can be either a borrowed as a str or converted into an owned String.

type Pos = Pos

A type that represent the position of a node.

fn read(&mut self) -> Result<ReadItem<&'a str, Pos>, ParseError>

Reads from the source. It shall panic if the root node has been completely read (e.g., the ListEnding that matches the first ListBeginning has been read).

fn finish(self) -> Result<(), ParseError>

Finished the reader, consuming it. It must be called only after the root node has been completely read. It may return an error if an error is encountered after the root node (e.g., trailing tokens at the end of the file).