Struct StartElementBuilder

pub struct StartElementBuilder<'a> { /* private fields */ }

A builder for a starting element event.

Implementations

impl<'a> StartElementBuilder<'a>

pub fn attr<N>(self, name: N, value: &'a str) -> Self

where N: Into<Name<'a>>,

Sets an attribute value of this element to the given string.

This method can be used to add attributes to the starting element. Name is a qualified name; its namespace is ignored, but its prefix is checked for correctness, that is, it is checked that the prefix is bound to some namespace in the current context.

Currently attributes are not checked for duplicates. Note that duplicate attributes are a violation of XML document well-formedness.

The writer checks that you don’t specify reserved prefix names, for example xmlns.

pub fn ns<S1, S2>(self, prefix: S1, uri: S2) -> Self

where S1: Into<String>, S2: Into<String>,

Adds a namespace to the current namespace context.

If no namespace URI was bound to the provided prefix at this point of the document, then the mapping from the prefix to the provided namespace URI will be written as a part of this element attribute set.

If the same namespace URI was bound to the provided prefix at this point of the document, then no namespace attributes will be emitted.

If some other namespace URI was bound to the provided prefix at this point of the document, then another binding will be added as a part of this element attribute set, shadowing the outer binding.

pub fn default_ns<S>(self, uri: S) -> Self

where S: Into<String>,

Adds a default namespace mapping to the current namespace context.

Same rules as for ns() are also valid for the default namespace mapping.

Trait Implementations

impl<'a> From<StartElementBuilder<'a>> for XmlEvent<'a>

fn from(b: StartElementBuilder<'a>) -> Self

Converts to this type from the input type.