Struct xml_builder::XMLElement

pub struct XMLElement { /* fields omitted */ }

Structure representing an XML element field.

Implementations

impl XMLElement

pub fn new(name: &str) -> Self

Instantiates a XMLElement object.

Arguments

• name - A string slice that holds the name of the XML element.

pub fn set_attribute_sorting(&mut self, should_sort: bool)

Sets whether attributes should be sorted or not.

Arguments

• should_sort - A boolean indicating whether attributes should be sorted or not.

pub fn add_attribute(&mut self, name: &str, value: &str)

Adds the given name/value attribute to the XMLElement.

Arguments

• name - A string slice that holds the name of the attribute
• value - A string slice that holds the value of the attribute

pub fn add_child(&mut self, element: XMLElement) -> Result<()>

Adds a new XMLElement child object to the references XMLElement. Raises a XMLError if trying to add a child to a text XMLElement.

Arguments

• element - A XMLElement object to add as child

pub fn add_text(&mut self, text: String) -> Result<()>

Adds text content to a XMLElement object. Raises a XMLError if trying to add text to a non-empty object.

Arguments

• text - A string containing the text to add to the object

pub fn render<W: Write>(
    &self,
    writer: &mut W,
    should_sort: bool,
    should_indent: bool
) -> Result<()>

Renders an XMLElement object into the specified writer implementing Write trait. Does not take ownership of the object.

Arguments

• writer - An object to render the referenced XMLElement to