Struct XmlDeserializer 

pub struct XmlDeserializer<'de> { /* private fields */ }

Low-level serde XML deserializer.

Most callers should use the convenience entry points from_str / from_bytes rather than constructing this directly. Use XmlDeserializer when you want to drive the serde Deserializer trait against XML events yourself — for example, plugging into a custom visitor or chaining with a seed-based DeserializeSeed flow.

Holds an XmlReader and a one-event lookahead so peeking is cheap.

Implementations

impl<'de> XmlDeserializer<'de>

pub fn from_str(input: &'de str) -> Self

Build a deserializer over a string slice with default options.

pub fn from_str_opts(input: &'de str, opts: DeOptions) -> Self

Build a deserializer over a string slice with caller-supplied DeOptions. The options are forwarded to the underlying XmlReader and govern naming conventions (@ prefix, $text / $value field names) and behaviour (xsi:nil, unknown-field handling).

Trait Implementations

impl<'de, 'a> Deserializer<'de> for &'a mut XmlDeserializer<'de>

type Error = DeError

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

fn deserialize_any<V: Visitor<'de>>(self, _v: V) -> Result<V::Value, DeError>

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

fn deserialize_str<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

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_string<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

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

fn deserialize_i8<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting an i8 value.

fn deserialize_i16<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting an i16 value.

fn deserialize_i32<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting an i32 value.

fn deserialize_i64<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting an i64 value.

fn deserialize_i128<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting an i128 value.

fn deserialize_u8<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting a u8 value.

fn deserialize_u16<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting a u16 value.

fn deserialize_u32<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting a u32 value.

fn deserialize_u64<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting a u64 value.

fn deserialize_u128<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting an u128 value.

fn deserialize_f32<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting a f32 value.

fn deserialize_f64<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting a f64 value.

fn deserialize_bool<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting a bool value.

fn deserialize_char<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting a char value.

fn deserialize_bytes<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

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

fn deserialize_byte_buf<V: Visitor<'de>>( self, v: V, ) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting a byte array and would benefit from taking ownership of buffered data owned by the Deserializer.

fn deserialize_unit<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting a unit value.

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

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

fn deserialize_newtype_struct<V: Visitor<'de>>( self, _name: &'static str, v: V, ) -> Result<V::Value, DeError>

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

fn deserialize_ignored_any<V: Visitor<'de>>( self, v: V, ) -> Result<V::Value, DeError>

Hint that the Deserialize type needs to deserialize a value whose type doesn’t matter because it is ignored.

fn deserialize_struct<V: Visitor<'de>>( self, _name: &'static str, fields: &'static [&'static str], v: V, ) -> Result<V::Value, DeError>

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

fn deserialize_seq<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting a sequence of values.

fn deserialize_tuple<V: Visitor<'de>>( self, _len: usize, v: V, ) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting a sequence of values and knows how many values there are without looking at the serialized data.

fn deserialize_tuple_struct<V: Visitor<'de>>( self, _name: &'static str, _len: usize, v: V, ) -> Result<V::Value, DeError>

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

fn deserialize_map<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting a map of key-value pairs.

fn deserialize_option<V: Visitor<'de>>(self, v: V) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting an optional value.

fn deserialize_enum<V: Visitor<'de>>( self, _name: &'static str, _variants: &'static [&'static str], v: V, ) -> Result<V::Value, DeError>

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

fn deserialize_identifier<V: Visitor<'de>>( self, v: V, ) -> Result<V::Value, DeError>

Hint that the Deserialize type is expecting the name of a struct field or the discriminant of an enum variant.

fn is_human_readable(&self) -> bool

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