Struct DeserializeOptions 

pub struct DeserializeOptions {
    pub deny_unknown_fields: bool,
}

Options for controlling XML deserialization behavior.

Example

use facet::Facet;
use facet_xml::{self as xml, DeserializeOptions};

#[derive(Facet, Debug, PartialEq)]
struct Person {
    #[facet(xml::attribute)]
    name: String,
}

let xml_str = r#"<Person name="Alice" extra="unknown"/>"#;

// Without options: unknown attributes are silently ignored
let person: Person = xml::from_str(xml_str).unwrap();
assert_eq!(person.name, "Alice");

// With deny_unknown_fields: unknown attributes cause an error
let options = DeserializeOptions::default().deny_unknown_fields(true);
let result: Result<Person, _> = xml::from_str_with_options(xml_str, &options);
assert!(result.is_err());

Fields

deny_unknown_fields: bool

If true, reject XML documents with unknown attributes or elements that don’t correspond to any field in the target struct.

When false (the default), unknown attributes and elements are silently ignored.

This option is combined with any #[facet(deny_unknown_fields)] attribute on the struct - if either is set, unknown fields cause an error.

Implementations

impl DeserializeOptions

pub fn new() -> Self

Create new options with default values.

pub fn deny_unknown_fields(self, deny: bool) -> Self

Set whether to deny unknown fields.

When enabled, deserialization will fail if the XML contains attributes or elements that don’t match any field in the struct.

Trait Implementations

impl Clone for DeserializeOptions

fn clone(&self) -> DeserializeOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DeserializeOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for DeserializeOptions

fn default() -> DeserializeOptions

Returns the “default value” for a type.