Struct sise::AtomReadUtil

pub struct AtomReadUtil<R: Reader> { /* fields omitted */ }

Utility to read atom nodes.

Methods

impl<R: Reader> AtomReadUtil<R>

pub fn new(pos: R::Pos, atom: R::String) -> Self

pub fn pos(&self) -> &R::Pos

Returns a reference to the atom position stored in this utility.

pub fn atom(&self) -> &R::String

Returns a reference to the atom value stored in this utility.

pub fn into_atom(self) -> R::String

Consumes self and returns the stored atom value.

pub fn into_pos(self) -> R::Pos

Consumes self and returns the stored position.

pub fn into_pos_atom(self) -> (R::Pos, R::String)

Consumes self and returns the stored atom position and value.

pub fn decode<T, F>(
    self,
    f: F,
    value_type: &str
) -> Result<T, ReadUtilError<R::Error, R::Pos>> where
    F: FnOnce(&str) -> Option<T>, 

Decodes the atom using an user-provided function.

The function shall return None if the decodification fails. In such case, ReadError::InvalidValue will be returned, with the value of value_type.

Example

let src_data = b"example";
let mut parser = sise::Parser::new(src_data);
let node_read_util = sise::NodeReadUtil::new(&mut parser).unwrap();
let atom_read_util = node_read_util.expect_atom().unwrap();
let decoded = atom_read_util.decode(|atom| Some(atom.len()), "decode_as_length").unwrap();
assert_eq!(decoded, 7);