Struct OwnedDriver 

pub struct OwnedDriver<'de, T> { /* private fields */ }

A DeserializeDriver which owns the value it deserializes.

A DeserializeDriver borrows the slot of the value it deserializes, which means that it cannot be held together with the slot, for instance in a struct that deserializes a value from input which arrives over time. This bundles a driver with its slot. The driver is lent out with with and the value is taken with finish:

use deser::de::OwnedDriver;
use deser::Event;

let mut driver = OwnedDriver::<Vec<u32>>::new();
driver.with(|driver| driver.emit(Event::seq_start())).unwrap();
// ... later, when more input arrived
driver.with(|driver| {
    driver.emit(1u64)?;
    driver.emit(Event::SeqEnd)
}).unwrap();
assert_eq!(driver.finish().unwrap(), [1]);

Implementations

impl<'de, T: Deserialize<'de>> OwnedDriver<'de, T>

pub fn new() -> OwnedDriver<'de, T>

Creates a driver for a value.

impl<'de, T> OwnedDriver<'de, T>

pub fn with<R, F>(&mut self, f: F) -> R

where F: for<'a> FnOnce(&mut DeserializeDriver<'a, 'de>) -> R,

Invokes a function with the driver.

The function has to accept a driver of any lifetime which ensures that it cannot keep the driver or replace it.

pub fn driver(&self) -> &DeserializeDriver<'_, 'de>

Returns a reference to the driver.

pub fn finish(self) -> Result<T, Error>

Finishes the deserialization and returns the value.

Fails with ErrorKind::EndOfFile if the value is incomplete.

Trait Implementations

impl<'de, T: Deserialize<'de>> Default for OwnedDriver<'de, T>

fn default() -> OwnedDriver<'de, T>

Returns the “default value” for a type.

impl<'de, T> Drop for OwnedDriver<'de, T>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.