NAME

       WebKDC::XmlElement - Parse and manipulate XML documents and elements

SYNOPSIS

           use WebKDC::XmlElement;

           my $root = WebKDC::XmlElement->new ($xml);
           my $e = $root->find_child ('foo');
           my $content = $e->content_trimmed;
           print $root->to_string (1);

DESCRIPTION

       A WebKDC::XmlElement object represents an XML element, including its attributes, textual
       content, and any nested elements.  It therefore can represent an entire XML document,
       although XML documents are normally constructed via the methods provided by
       WebKDC::XmlDoc.  It is used internally by the WebKDC module to create and parse XML
       documents when talking to a WebAuth WebKDC.

CLASS METHODS

       new ([XML])
           Create a new WebKDC::XmlElement.  If XML is given, do so by parsing that XML using
           XML::Parser.  The resulting element will represent the complete structure of that
           document, including any nested elements, any attributes, and any non-element content.

INSTANCE METHODS

       add_child (ELEMENT)
           Add a WebKDC::XmlElement object as a child of this element.  It will be appended to
           the end of the list of all existing children.

       append_content (CONTENT)
           Append the provided content to the textual content of this element.

       attr (NAME[, VALUE])
           Retrieve or set the value of a specific attribute.  Returns undef if that attribute
           isn't present for this element.

       attrs ([ATTRS])
           Retrieve or set the attributes for this element (as a reference to an anonymous hash).

       children ([CHILDREN])
           Retrieve or set the children of this element (as a reference to an anonymous array of
           WebKDC::XmlElement objects).

       content ([CONTENT])
           Retrieve or set the textual content of this element as a string, not including any
           child elements.  Returns undef if the element has no content.

       content_trimmed ()
           Retrieve the textual content of this element with all leading and trailing whitespace
           removed.  Returns undef if the element has no content.

       find_child (NAME)
           Returns the first child (as a WebKDC::XmlElement object) of this element whose name
           matches NAME.

       has_attrs ()
           Returns true if this element has attributes, false otherwise.

       has_children ()
           Returns true if this element has children, false otherwise.

       name ([NAME])
           Retrieve or set the name of this element as a string.

       to_string ()
           Convert this XML element (and, recursively, all of its children) to XML.

AUTHOR

       Roland Schemers and Russ Allbery <eagle@eyrie.org>

SEE ALSO

       WebKDC(3), WebKDC::XmlDoc(3)

       This module is part of WebAuth.  The current version is available from
       <http://webauth.stanford.edu/>.