Struct Decoder 

pub struct Decoder<'b> { /* private fields */ }

Reads the binary form. The step-by-step reads (Decoder::int, Decoder::map …) answer None for anything but what crate::Schema::encode writes there — the schema then reads the slow way, which says what’s wrong.

Implementations

impl<'b> Decoder<'b>

pub fn open(bytes: &'b [u8]) -> Result<Self, DecodeError>

After the header: the root value next. Versions 1 and 2 are read; a version 1 document may use only the tags it was written with.

Errors

DecodeError when the header isn’t SDAT and a version this reads.

pub fn at_end(&self) -> bool

Whether every byte was read.

impl<'b> Decoder<'b>

pub fn value_ref<'a>( &mut self, arena: &'a Bump, ) -> Result<ValueRef<'a>, DecodeError>

where 'b: 'a,

The next value, borrowed: strings point into the bytes, lists and maps go in arena.

Errors

DecodeError when the bytes aren’t a value.

impl<'b> Decoder<'b>

pub fn null(&mut self) -> bool

Whether a null is next: read if it is.

pub fn bool(&mut self) -> Option<bool>

A bool, if one is next.

pub fn int(&mut self) -> Option<i64>

An integer, if one is next.

pub fn float(&mut self) -> Option<f64>

A float — or an int, as a number.

pub fn str(&mut self) -> Option<&'b str>

A string, if one is next.

pub fn bytes(&mut self) -> Option<&'b [u8]>

Bytes, if they’re next.

pub fn list(&mut self) -> Option<usize>

A list next: how many values; Decoder::leave after them.

pub fn ints(&mut self) -> Option<usize>

A packed list of ints next (Decoder::packed_int each): how many.

pub fn stream(&mut self) -> Option<&'b [u8]>

A stream next: its body (count and values, strings its own).

pub fn floats(&mut self) -> Option<Vec<f64>>

A packed list of floats next: each one. (Written narrow when they fit: widened back.)

pub fn floats32(&mut self) -> Option<Vec<f32>>

A packed list of 32-bit floats next: each one.

pub fn packed_int(&mut self) -> Option<i64>

One int of a packed list.

pub fn map(&mut self) -> Option<usize>

A map next: how many entries, each a Decoder::key and a value; Decoder::leave after them.

pub fn leave(&mut self)

The end of a list or map.

pub fn key(&mut self) -> Option<&'b str>

A map’s next key.

pub fn skip(&mut self) -> Option<()>

The next value, read and left (its strings still join the table).

impl Decoder<'_>

pub fn value(&mut self) -> Result<Value, DecodeError>

The next value, owned.

Errors

DecodeError when the bytes aren’t a value.

Trait Implementations

impl<'b> Debug for Decoder<'b>

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

Formats the value using the given formatter.