Struct Upgrade 

pub struct Upgrade<Latest, Prior, Err>
where
    Err: Error,
    Prior: Versioned<Err>,
    Latest: Versioned<Err>,
    Latest::Output: TryFrom<Prior::Output>,
{ /* private fields */ }

The Upgrade struct is used to upgrade data from a previous version to the latest version.

Prior::VERSION must be less than Latest::VERSION!

Upgrades can be chained!

Trait Implementations

impl<Latest, Prior, Dec, Err> Decodable<Dec, Err> for Upgrade<Latest, Prior, Err>

where Dec: Decoder, Prior: Versioned<Err> + Decodable<Dec, Err>, Prior::Output: Decode<Dec>, Latest: Versioned<Err> + Decodable<Dec, Err>, Latest::Output: TryFrom<Prior::Output> + Decode<Dec>, Err: Error + From<<Dec as Decoder>::Error> + From<<Latest::Output as TryFrom<Prior::Output>>::Error>,

fn decode_with_version( decoder: &mut Dec, version: u32, ) -> Result<Self::Output, Err>

Decodes the data with a provided version tag. Is helpful for use in combination with Upgrade.

fn decode(decoder: &mut Dec) -> Result<Self::Output, Err>

Decodes versioned data and validates the version. Will consume the version from the reader.

unsafe fn decode_body(decoder: &mut Dec) -> Result<Self::Output, Err>

Decodes only the body, assuming the version has already been validated.

impl<Latest, Prior, Enc, Err> Encodable<Enc, Err> for Upgrade<Latest, Prior, Err>

where Err: Error + From<<Enc as Encoder>::Error>, Enc: Encoder, Prior: Versioned<Err>, Latest: Versioned<Err>, Latest::Output: Encode<Enc> + TryFrom<Prior::Output>,

fn encode(data: &Self::Output, encoder: &mut Enc) -> Result<(), Err>

Encodes the data including the version tag.

impl<Latest, Prior, Err> Versioned<Err> for Upgrade<Latest, Prior, Err>

where Err: Error, Prior: Versioned<Err>, Latest: Versioned<Err>, Latest::Output: TryFrom<Prior::Output>,

const VERSION: u32 = Latest::VERSION

The version tag of this data

type Output = <Latest as Versioned<Err>>::Output

The type that the versioned data is encoding