/ 
XML-TinyXML-0.03
River stage zero No dependents
/ XML::TinyXML::Node

NAME

XML::TinyXML::Node - Tinyxml Node object

SYNOPSIS

    use XML::TinyXML;

# first obtain an xml context:
$xml = XML::TinyXML->new("rootnode", "somevalue", { attr1 => v1, attr2 => v2 });

# We create a node and later attach it to a parent one doing:
$child_node = XML::TinyXML::Node->new("child", "somevalue");
... [ some code ] ...
$parent_node->addChildNode($child_node);

# or if we want to create a childnode in a single statemnet
$child_node = XML::TinyXML::Node->new("child", "somevalue", $parent_node);

# we can later retrive the "child" node by calling
$child_node = $xml->getNode("/nodelabel/child");

# at this point , calling :
print $xml->dump;
# would produce the following xml
#
# <?xml version="1.0"?>
# <rootnode>
#   <child>othervalue</child>
# </rootnode>

DESCRIPTION

Node representation for the TinyXML API

INSTANCE VARIABLES

  • _node

    Reference to the underlying XmlNodePtr object (which is a binding to the XmlNode C structure)

METHODS

  • new ($entity, $value, $parent, %attrs)

    Creates a new XML::TinyXML::Node object.

    $entity can be either a scalar or an XmlNodePtr object. - if it's a scalar , it will be intepreted as the entity name - if it's an XmlNodePtr, it will be used as the underlying object and will be incapsulated in the newly created XML::TinyXML::Node object.

    $value is the optianal string value of the newly created node (the "content" of the xml node)

    if $parent isn't undef the newly created node will be directly attached to the specified parent node. $parent can be either a XML::TinyXML::Node object or a XmlNodePtr one.

    %attrs is an optional hash specifying attributes for the newly created xml node

    Returns a valid XML::TinyXML::Node object

  • cleanAttributes

  • loadHash ($hash, [ $nest ])

  • toHash ([ $parent ])

  • updateAttributes (%attrs)

  • addAttributes (%attrs)

  • name ([$newname])

  • value ([$newval])

  • attributes ()

    Read-Only method to obtain an hashref to the attributes of this node

  • getChildNode ($index)

  • getChildNodeByName ($name)

  • countChildren ()

  • children ()

  • addChildNode ($child)

  • parent ($child)

  • type () Returns the "type" of a XML::TinyXML::Node object. type can be : NODE COMMENT CDATA

SEE ALSO

    XML::TinyXML

AUTHOR

xant, <xant@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2008 by xant

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.