Trait FromEventsBuilder 

pub trait FromEventsBuilder {
    type Output;

    // Required method
    fn feed(
        &mut self,
        ev: Event,
        ctx: &Context<'_>,
    ) -> Result<Option<Self::Output>, Error>;
}

Trait for a temporary object allowing to construct a struct from rxml::Event items.

Objects of this type are generally constructed through FromXml::from_events and are used to build Rust structs or enums from XML data. The XML data must be fed as rxml::Event to the feed method.

Required Associated Types

type Output

The type which will be constructed by this builder.

Required Methods

fn feed( &mut self, ev: Event, ctx: &Context<'_>, ) -> Result<Option<Self::Output>, Error>

Feed another rxml::Event into the element construction process.

Once the construction process completes, Ok(Some(_)) is returned. When valid data has been fed but more events are needed to fully construct the resulting struct, Ok(None) is returned.

If the construction fails, Err(_) is returned. Errors are generally fatal and the builder should be assumed to be broken at that point. Feeding more events after an error may result in panics, errors or inconsistent result data, though it may never result in unsound or unsafe behaviour.

Implementations on Foreign Types

impl<T: FromEventsBuilder + ?Sized> FromEventsBuilder for Box<T>

type Output = <T as FromEventsBuilder>::Output

fn feed( &mut self, ev: Event, ctx: &Context<'_>, ) -> Result<Option<Self::Output>, Error>

Implementors

impl FromEventsBuilder for Discard

type Output = ()

impl FromEventsBuilder for ElementFromEvents

Available on crate feature minidom only.

type Output = Element

impl<E, T: TryFrom<Element, Error = E>> FromEventsBuilder for FromEventsViaElement<T>

where Error: From<E>,

Available on crate feature minidom only.

type Output = T

impl<O, T: FromEventsBuilder<Output = Box<O>>> FromEventsBuilder for UnboxBuilder<T>

type Output = O

impl<T: DynXso + ?Sized + 'static, B: FromEventsBuilder<Output = Box<T>>> FromEventsBuilder for DynBuilder<B>

type Output = Xso<T>

impl<T: FromEventsBuilder + ?Sized> FromEventsBuilder for BoxBuilder<T>

type Output = Box<<T as FromEventsBuilder>::Output>

impl<T: FromEventsBuilder> FromEventsBuilder for OptionBuilder<T>

type Output = Option<<T as FromEventsBuilder>::Output>

impl<T: FromEventsBuilder, E: From<Error>> FromEventsBuilder for FallibleBuilder<T, E>

type Output = Result<<T as FromEventsBuilder>::Output, E>