Struct TextDeserializer

pub struct TextDeserializer<'de>(pub Text<'de>);

A deserializer for a single text node of a mixed sequence of tags and text.

This deserializer are very similar to a MapValueDeserializer (when it processes the DeEvent::Text event). The only difference in the deserialize_seq method. This deserializer will perform deserialization from a textual content, whereas the MapValueDeserializer will iterate over tags / text within it’s parent tag.

This deserializer processes items as following:

• numbers are parsed from a text content using FromStr;
• booleans converted from the text according to the XML specification:
  • "true" and "1" converted to true;
  • "false" and "0" converted to false;
• strings returned as is;
• characters also returned as strings. If string contain more than one character or empty, it is responsibility of a type to return an error;
• Option:
  • empty text is deserialized as None;
  • everything else is deserialized as Some using the same deserializer;
• units (()) and unit structs always deserialized successfully;
• newtype structs forwards deserialization to the inner type using the same deserializer;
• sequences, tuples and tuple structs are deserialized using SimpleTypeDeserializer (this is the difference): text content passed to the deserializer directly;
• structs and maps calls Visitor::visit_borrowed_str or Visitor::visit_string, it is responsibility of the type to return an error if it do not able to process this data;
• enums:
  • the variant name is deserialized as $text;
  • the content is deserialized using the same deserializer:
    • unit variants: just return ();
    • newtype variants forwards deserialization to the inner type using the same deserializer;
    • tuple and struct variants are deserialized using SimpleTypeDeserializer.

Tuple Fields

0: Text<'de>

Implementations

impl<'de> TextDeserializer<'de>

fn read_string(self) -> Result<Cow<'de, str>, DeError>

Returns a next string as concatenated content of consequent Text and CData events, used inside deserialize_primitives!().

Trait Implementations

impl<'de> Deserializer<'de> for TextDeserializer<'de>

fn deserialize_char<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Character represented as strings.

fn deserialize_string<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Representation of owned strings the same as non-owned.

fn deserialize_bytes<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Forwards deserialization to the deserialize_any.

fn deserialize_byte_buf<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Forwards deserialization to the deserialize_bytes.

fn deserialize_unit_struct<V>( self, _name: &'static str, visitor: V, ) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Representation of the named units the same as unnamed units.

fn deserialize_tuple<V>( self, _len: usize, visitor: V, ) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Representation of tuples the same as sequences.

fn deserialize_tuple_struct<V>( self, _name: &'static str, len: usize, visitor: V, ) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Representation of named tuples the same as unnamed tuples.

fn deserialize_map<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Forwards deserialization to the deserialize_struct with empty name and fields.

fn deserialize_identifier<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Identifiers represented as strings.

fn deserialize_ignored_any<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Forwards deserialization to the deserialize_unit.

fn deserialize_newtype_struct<V>( self, _name: &'static str, visitor: V, ) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Forwards deserialization of the inner type. Always calls Visitor::visit_newtype_struct with this deserializer.

fn deserialize_seq<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

This method deserializes a sequence inside of element that itself is a sequence element:

<>
  ...
  inner sequence as xs:list
  ...
</>

type Error = DeError

The error type that can be returned if some error occurs during deserialization.

fn deserialize_i8<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an i8 value.

fn deserialize_i16<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an i16 value.

fn deserialize_i32<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an i32 value.

fn deserialize_i64<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an i64 value.

fn deserialize_u8<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a u8 value.

fn deserialize_u16<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a u16 value.

fn deserialize_u32<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a u32 value.

fn deserialize_u64<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a u64 value.

fn deserialize_i128<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an i128 value.

fn deserialize_u128<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an u128 value.

fn deserialize_f32<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a f32 value.

fn deserialize_f64<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a f64 value.

fn deserialize_bool<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a bool value.

fn deserialize_str<V>(self, visitor: V) -> Result<V::Value, DeError>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a string value and does not benefit from taking ownership of buffered data owned by the Deserializer.

fn deserialize_unit<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a unit value.

fn deserialize_option<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an optional value.

fn deserialize_struct<V>( self, _name: &'static str, _fields: &'static [&'static str], visitor: V, ) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a struct with a particular name and fields.

fn deserialize_enum<V>( self, _name: &'static str, _variants: &'static [&'static str], visitor: V, ) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an enum value with a particular name and possible variants.

fn deserialize_any<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Require the Deserializer to figure out how to drive the visitor based on what data type is in the input.

fn is_human_readable(&self) -> bool

Determine whether Deserialize implementations should expect to deserialize their human-readable form.

impl<'de> EnumAccess<'de> for TextDeserializer<'de>

type Error = DeError

The error type that can be returned if some error occurs during deserialization.

type Variant = TextDeserializer<'de>

The Visitor that will be used to deserialize the content of the enum variant.

fn variant_seed<V>( self, seed: V, ) -> Result<(V::Value, Self::Variant), Self::Error>

where V: DeserializeSeed<'de>,

variant is called to identify which variant to deserialize.

fn variant<V>(self) -> Result<(V, Self::Variant), Self::Error>

where V: Deserialize<'de>,

variant is called to identify which variant to deserialize.

impl<'de> VariantAccess<'de> for TextDeserializer<'de>

type Error = DeError

The error type that can be returned if some error occurs during deserialization. Must match the error type of our EnumAccess.

fn unit_variant(self) -> Result<(), Self::Error>

Called when deserializing a variant with no values.

fn newtype_variant_seed<T>(self, seed: T) -> Result<T::Value, Self::Error>

where T: DeserializeSeed<'de>,

Called when deserializing a variant with a single value.

fn tuple_variant<V>( self, len: usize, visitor: V, ) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Called when deserializing a tuple-like variant.

fn struct_variant<V>( self, fields: &'static [&'static str], visitor: V, ) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Called when deserializing a struct-like variant.

fn newtype_variant<T>(self) -> Result<T, Self::Error>

where T: Deserialize<'de>,

Called when deserializing a variant with a single value.