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>