.. efun:: string xml_generate(mixed *xml)
  :optional:
  :experimental:
  :include: <xml.h>

  Converts the given :arg:`xml` array into an XML conformant string, if possible. The :arg:`xml` argument array must have the following structure:

  It must contain tag arrays of three elements, with the following indices:

  string :macro:`XML_TAG_NAME`
    The name of the XML tag.

  mapping :macro:`XML_TAG_ATTRIBUTES`
    All attributes given to the XML tag as a mapping where the key is the attribute name and the value is its string value.

    If the xml tag does not contain any attributes, this element is set to 0.

  mixed * :macro:`XML_TAG_CONTENTS`
    The contents of this xml tag as an array. This array may contain either strings, or arrays of sub-tags again with three elements. (see example)

    If the xml tag does not contain anything, the element is set to 0.

  In case the parameter does not follow these rules, errors are raised. The method returns a valid XML string otherwise.

  The function is available only if the driver is compiled with Iksemel support. In that case, :macro:`__XML_DOM__` is defined.

  .. usage::

    For starters, here's how you can generate individual tags::

      xml_generate(({ "abc", 0, 0 }));                   // "<abc/>"
      xml_generate(({ "abc", ([ "xyz" : "cde" ]), 0 })); // "<abc xyz="cde"/>"

    Nested tags get complicated (and hard to read) quickly, so it's important to format them consistently::

      mixed *xml = ({ "book"
                    , ([ "language" : "common" ])
                    , ({ ({ "title"
                          , 0
                          , ({ "This is a title" })
                         })
                       , ({ "chapter"
                          , 0
                          , ({ "This is a chapter" })
                         })
                       , ({ "chapter"
                          , 0
                          , ({ "We want "
                             , ({ "b"
                                , 0
                                , ({ "bold" })
                               })
                             , "here"
                            })
                         })
                      })
                   });

      xml_generate(xml); // "<book language="common"><title>This is the title</title><chapter>This is a chapter</chapter><chapter>We want <b>bold</b> here.</chapter></book>"

  :history 3.3.718 introduced:

  .. seealso:: :efun:`xml_parse`