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 EmptyAsError

impl TextCodec<String> for Plain

impl TextCodec<Vec<u8>> for ColonSeparatedHex

impl<'x, Filter: TextFilter> TextCodec<Cow<'x, [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.

impl<T, Filter: TextFilter> TextCodec<Option<T>> for Base64<Filter>

where Base64<Filter>: TextCodec<T>,

Available on crate feature base64 only.

impl<T, const N: usize> TextCodec<Option<T>> for FixedHex<N>

where FixedHex<N>: TextCodec<T>,

impl<const N: usize> TextCodec<[u8; N]> for FixedHex<N>