Element nodes have attributes as well as child nodes. More...
#include <libxml++/nodes/element.h>
List of all members.
Public Types |
| typedef std::list< Attribute* > | AttributeList |
Public Member Functions |
| | Element (_xmlNode* node) |
| virtual | ~Element () |
| void | set_namespace_declaration (const Glib::ustring& ns_uri, const Glib::ustring& ns_prefix=Glib::ustring()) |
| | This adds a namespace declaration to this node which will apply to this node and all children.
|
| AttributeList | get_attributes () |
| | Obtain the list of attributes for this element.
|
| const AttributeList | get_attributes () const |
| | Obtain the list of attributes for this element.
|
| Attribute* | get_attribute (const Glib::ustring& name, const Glib::ustring& ns_prefix=Glib::ustring()) const |
| Glib::ustring | get_attribute_value (const Glib::ustring& name, const Glib::ustring& ns_prefix=Glib::ustring()) const |
| | Get the value of the attribute with this name, and optionally with this namespace.
|
| Attribute* | set_attribute (const Glib::ustring& name, const Glib::ustring& value, const Glib::ustring& ns_prefix=Glib::ustring()) |
| | Set the value of the attribute with this name, and optionally with this namespace.
|
| void | remove_attribute (const Glib::ustring& name, const Glib::ustring& ns_prefix=Glib::ustring()) |
| | Remove the attribute with this name, and optionally with this namespace.
|
| TextNode* | get_child_text () |
| | Get the first child text content node.
|
| const TextNode* | get_child_text () const |
| | Get the first child text content node.
|
| TextNode* | add_child_text (const Glib::ustring& content=Glib::ustring()) |
| | Append a new text node.
|
| TextNode* | add_child_text (xmlpp::Node* previous_sibling, const Glib::ustring& content=Glib::ustring()) |
| | Add a new text node after the specified existing child node.
|
| TextNode* | add_child_text_before (xmlpp::Node* next_sibling, const Glib::ustring& content=Glib::ustring()) |
| | Add a new text node before the specified existing child node.
|
| void | set_child_text (const Glib::ustring& content) |
| | Set the text of the first text node, adding one if necessary.
|
| bool | has_child_text () const |
| | Discover whether one of the child nodes is a text node.
|
| CommentNode* | add_child_comment (const Glib::ustring& content) |
| | Append a new comment node.
|
Protected Member Functions |
| Glib::ustring | get_namespace_uri_for_prefix (const Glib::ustring& ns_prefix) const |
Detailed Description
Element nodes have attributes as well as child nodes.
This will be instantiated by the parser.
Member Typedef Documentation
Constructor & Destructor Documentation
| xmlpp::Element::Element |
( |
_xmlNode * |
node ) |
[explicit] |
| virtual xmlpp::Element::~Element |
( |
) |
[virtual] |
Member Function Documentation
Append a new comment node.
- Parameters:
-
- Returns:
- The new comment node.
Add a new text node after the specified existing child node.
- Since libxml++ 2.24:
- Parameters:
-
- Returns:
- The new text node.
Append a new text node.
- Parameters:
-
- Returns:
- The new text node.
Add a new text node before the specified existing child node.
- Since libxml++ 2.24:
- Parameters:
-
- Returns:
- The new text node.
Get the value of the attribute with this name, and optionally with this namespace.
For finer control, you might use get_attribute() and use the methods of the Attribute class.
- Parameters:
-
| name | The name of the attribute whose value will be retrieved. |
| ns_prefix | Namespace prefix. |
- Returns:
- The text value of the attribute, or an empty string if no such attribute was found.
- Since libxml++ 2.20:
Obtain the list of attributes for this element.
- Returns:
- The list of attributes.
Obtain the list of attributes for this element.
- Returns:
- The list of attributes.
| TextNode* xmlpp::Element::get_child_text |
( |
) |
|
Get the first child text content node.
This is a convenience method, meant as an alternative to iterating over all the child nodes to find the first suitable node then and getting the text directly.
- Returns:
- The first text node, if any.
| const TextNode* xmlpp::Element::get_child_text |
( |
) |
const |
Get the first child text content node.
This is a convenience method, meant as an alternative to iterating over all the child nodes to find the first suitable node then and getting the text directly.
- Returns:
- The first text node, if any.
| bool xmlpp::Element::has_child_text |
( |
) |
const |
Discover whether one of the child nodes is a text node.
This is a convenience method, meant as an alternative to iterating over all the child nodes and examining them directly.
- Returns:
- Whether this node has a child text node.
Remove the attribute with this name, and optionally with this namespace.
- Parameters:
-
| name | The name of the attribute to be removed |
| ns_prefix | Namespace prefix. If specified, the attribute will be removed only if the attribute has this namespace. |
Set the value of the attribute with this name, and optionally with this namespace.
A matching attribute will be added if no matching attribute already exists. For finer control, you might want to use get_attribute() and use the methods of the Attribute class.
- Parameters:
-
| name | The name of the attribute whose value will change. |
| value | The new value for the attribute |
| ns_prefix | Namespace prefix. If the prefix has not been declared then this method will throw an exception. |
- Returns:
- The attribute that was changed, or 0 is no suitable Attribute was found.
| void xmlpp::Element::set_child_text |
( |
const Glib::ustring & |
content ) |
|
Set the text of the first text node, adding one if necessary.
This is a convenience method, meant as an alternative to iterating over all the child nodes to find the first suitable node then and setting the text directly.
- Parameters:
-
This adds a namespace declaration to this node which will apply to this node and all children.
- Parameters:
-
| ns_uri | The namespace to associate with the prefix, or to use as the default namespace if no prefix is specified. |
| ns_prefix | The namespace prefix. If no prefix is specified then the namespace URI will be the default namespace. |
The documentation for this class was generated from the following file: