Trait xso::TextCodec

pub trait TextCodec<T> {
    // Required methods
    fn decode(s: String) -> Result<T, Error>;
    fn encode(value: &T) -> Result<Option<Cow<'_, str>>, Error>;
}

Represent a way to encode/decode text data into a Rust type.

 This trait can be used in scenarios where implementing FromXmlText and/or AsXmlText on a type is not feasible or sensible, such as the following:

1. The type originates in a foreign crate, preventing the implementation of foreign traits.

2. There is more than one way to convert a value to/from XML.

The codec to use for a text can be specified in the attributes understood by FromXml and AsXml derive macros. See the documentation of the FromXml derive macro for details.

Required Methods

fn decode(s: String) -> Result<T, Error>

Decode a string value into the type.

fn encode(value: &T) -> Result<Option<Cow<'_, str>>, Error>

Encode the type as string value.

If this returns None, the string value is not emitted at all.

Object Safety

This trait is not object safe.

Implementors

impl TextCodec<Option<String>> for EmptyAsNone

impl TextCodec<String> for Plain

impl<Filter: TextFilter> TextCodec<Option<Vec<u8>>> for Base64<Filter>

Available on crate feature base64 only.

impl<Filter: TextFilter> TextCodec<Vec<u8>> for Base64<Filter>

Available on crate feature base64 only.