lukasfri · lukasfri · Jan 15, 2026 · Jan 15, 2026 · Copilot · Jan 15, 2026
diff --git a/xmlity-quick-xml/examples/xml_root.rs b/xmlity-quick-xml/examples/xml_root.rs
@@ -0,0 +1,31 @@
+use xmlity::{types::utils::XmlRoot, Deserialize};
+
+const EXAMPLE_XML_WITH_DECL: &str = r#"
+<?xml version="1.0" encoding="UTF-8"?>
+<root>
+    <value>Example</value>
+</root>
+"#;
+
+#[derive(Debug, Deserialize, PartialEq)]
+#[xelement(name = "root")]
+struct Root {
+    #[xelement(name = "value")]
+    value: String,
+}
+
+pub fn main() {
+    let root = xmlity_quick_xml::from_str::<XmlRoot<Root>>(EXAMPLE_XML_WITH_DECL.trim())
+        .unwrap()
+        .into_value()
+        .unwrap();
+
+    assert_eq!(
+        root,
+        Root {
+            value: "Example".to_string(),
+        }
+    );
+
+    println!("Deserialized successfully: {:?}", root);
+}
diff --git a/xmlity/src/types/utils.rs b/xmlity/src/types/utils.rs
@@ -281,6 +281,28 @@ impl<T> XmlRoot<T> {
         );
         self
     }
+
+    /// Gets the first value element of the XML document, if any.
+    pub fn value(&self) -> Option<&T> {
+        self.elements.iter().find_map(|e| {
+            if let XmlRootTop::Value(v) = e {
+                Some(v)
+            } else {
+                None
+            }
+        })
+    }
+
+    /// Consumes the XML document and returns the first value element, if any.
+    pub fn into_value(self) -> Option<T> {
+        self.elements.into_iter().find_map(|e| {
+            if let XmlRootTop::Value(v) = e {
+                Some(v)
+            } else {
+                None
+            }
+        })
-        self.elements.iter().find_map(|e| {
-            if let XmlRootTop::Value(v) = e {
-                Some(v)
-            } else {
-                None
-            }
-        })
-    }
-
-    /// Consumes the XML document and returns the first value element, if any.
-    pub fn into_value(self) -> Option<T> {
-        self.elements.into_iter().find_map(|e| {
-            if let XmlRootTop::Value(v) = e {
-                Some(v)
-            } else {
-                None
-            }
-        })
+        self.elements
+            .iter()
+            .find_map(|e| match e {
+                XmlRootTop::Value(v) => Some(v),
+                _ => None,
+            })
+    }
+
+    /// Consumes the XML document and returns the first value element, if any.
+    pub fn into_value(self) -> Option<T> {
+        self.elements
+            .into_iter()
+            .find_map(|e| match e {
+                XmlRootTop::Value(v) => Some(v),
+                _ => None,
+            })
-        self.elements.iter().find_map(|e| {
-            if let XmlRootTop::Value(v) = e {
-                Some(v)
-            } else {
-                None
-            }
-        })
-    }
-
-    /// Consumes the XML document and returns the first value element, if any.
-    pub fn into_value(self) -> Option<T> {
-        self.elements.into_iter().find_map(|e| {
-            if let XmlRootTop::Value(v) = e {
-                Some(v)
-            } else {
-                None
-            }
-        })
+        for e in &self.elements {
+            if let XmlRootTop::Value(v) = e {
+                return Some(v);
+            }
+        }
+        None
+    }
+
+    /// Consumes the XML document and returns the first value element, if any.
+    pub fn into_value(self) -> Option<T> {
+        for e in self.elements {
+            if let XmlRootTop::Value(v) = e {
+                return Some(v);
+            }
+        }
+        None
-        self.elements.iter().find_map(|e| {
-            if let XmlRootTop::Value(v) = e {
-                Some(v)
-            } else {
-                None
-            }
-        })
-    }
-
-    /// Consumes the XML document and returns the first value element, if any.
-    pub fn into_value(self) -> Option<T> {
-        self.elements.into_iter().find_map(|e| {
-            if let XmlRootTop::Value(v) = e {
-                Some(v)
-            } else {
-                None
-            }
-        })
+        self.elements
+            .iter()
+            .find_map(|e| match e {
+                XmlRootTop::Value(v) => Some(v),
+                _ => None,
+            })
+    }
+
+    /// Consumes the XML document and returns the first value element, if any.
+    pub fn into_value(self) -> Option<T> {
+        self.elements
+            .into_iter()
+            .find_map(|e| match e {
+                XmlRootTop::Value(v) => Some(v),
+                _ => None,
+            })
-        self.elements.iter().find_map(|e| {
-            if let XmlRootTop::Value(v) = e {
-                Some(v)
-            } else {
-                None
-            }
-        })
-    }
-
-    /// Consumes the XML document and returns the first value element, if any.
-    pub fn into_value(self) -> Option<T> {
-        self.elements.into_iter().find_map(|e| {
-            if let XmlRootTop::Value(v) = e {
-                Some(v)
-            } else {
-                None
-            }
-        })
+        for e in &self.elements {
+            if let XmlRootTop::Value(v) = e {
+                return Some(v);
+            }
+        }
+        None
+    }
+
+    /// Consumes the XML document and returns the first value element, if any.
+    pub fn into_value(self) -> Option<T> {
+        for e in self.elements {
+            if let XmlRootTop::Value(v) = e {
+                return Some(v);
+            }
+        }
+        None
+    }
 }
 
 impl<T> Default for XmlRoot<T> {