Struct Results 

pub struct Results<E: Serialize> { /* private fields */ }

The handler’s channel for the values a command produces while it runs.

Not Clone: Handler::handle receives it as a &mut borrow the framework owns, and a clone would let a handler keep emitting past its own run.

Implementations

impl<E: Serialize> Results<E>

pub fn discarding() -> Self

pub fn recording(recorder: RunRecorder) -> Self

pub fn for_run(recorder: Option<RunRecorder>, sink: Rc<dyn EventSink>) -> Self

The channel a run installs: every value is written, and retained too when the entry point has a recorder that keeps events.

pub fn emit(&mut self, event: E) -> Result<(), EmitError>

Returns once the value has been written and retained; fails when it does not serialize, does not render, or cannot be written. The write comes first, so a value the destination refused is never retained. Every failure reaches the sink, the serialization one through EventSink::record_failure because it happens before the write.

Trait Implementations

impl<E: Serialize> Debug for Results<E>

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

Formats the value using the given formatter.