The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

XML::LibXML::Attr - The DOM Attribute Class

synopsis

 use XML::LibXML

 $attr = XML::LibXML::Attr->new($name [,$value]);
 $string = $attr->getValue();
 $value = $attr->value;
 $attr->setValue( $string );
 $node = $attr->getOwnerElement();
 $attr->setNamespace($nsURI, $prefix);

DESCRIPTION

This is the interface to handle Attributes like ordinary nodes. The naming of the class relies on the W3C DOM documentation.

Methods

new

Class constructor. If you need to work with iso encoded strings, you should allways use the createAttrbute of XML::LibXML::Document.

getValue

Returns the value stored for the attribute. If undef is returned, the attribute has no value, which is different of being not specified.

value

Alias for getValue()

setValue

This is needed to set a new attributevalue. If iso encoded strings are passed as parameter, the node has to be bound to a document, otherwise the encoding might be wrong done.

getOwnerElement

returns the node the attribute belongs to. If the attribute is not bound to a node, undef will be returned. Overwriting the underlaying implementation, the parentNode function will return undef, instead of the owner element.

setNamespace

This function activates a namespace for the given attribute. If the attribute was not previously declared in the context of the attribute this function will be silently ignored. In this case you may wish to call setNamespace() on the ownerElement.

AUTHOR

Matt Sergeant, Christian Glahn

SEE ALSO

XML::LibXML, XML::LibXML::Node, XML::LibXML::Element, XML::LibXML::Document, XML::LibXML::DocumentFragment

VERSION

1.53