/usr/include/libxml++-2.6/libxml++/nodes/element.h is in libxml++2.6-dev 2.34.2-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 | /* element.h
* libxml++ and this file are copyright (C) 2000 by Ari Johnson, and
* are covered by the GNU Lesser General Public License, which should be
* included with libxml++ as the file COPYING.
*/
#ifndef __LIBXMLPP_NODES_ELEMENT_H
#define __LIBXMLPP_NODES_ELEMENT_H
#include <libxml++/nodes/node.h>
#include <libxml++/attribute.h>
#include <libxml++/nodes/commentnode.h>
#include <libxml++/nodes/cdatanode.h>
namespace xmlpp
{
/** Element nodes have attributes as well as child nodes. This will be instantiated by the parser.
*/
class Element : public Node
{
public:
explicit Element(_xmlNode* node);
virtual ~Element();
typedef std::list<Attribute*> AttributeList;
/** This adds a namespace declaration to this node which will apply to this node and all children.
* @param ns_uri The namespace to associate with the prefix, or to use as the default namespace if no prefix is specified.
* @param ns_prefix The namespace prefix. If no prefix is specified then the namespace URI will be the default namespace.
*/
void set_namespace_declaration(const Glib::ustring& ns_uri, const Glib::ustring& ns_prefix = Glib::ustring());
/** Obtain the list of attributes for this element.
* @returns The list of attributes.
*/
AttributeList get_attributes();
/** Obtain the list of attributes for this element.
* @returns The list of attributes.
*/
const AttributeList get_attributes() const;
//TODO: There should be a const and non-const version.
//See the patch at https://bugzilla.gnome.org/show_bug.cgi?id=632524
// FIXME: the following only returns explicitely provided
// attributes, not default ones declared in the dtd.
// TOOD: Is this still true? murrayc
Attribute* get_attribute(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.
* For finer control, you might use get_attribute() and use the methods of the Attribute class.
* @param name The name of the attribute whose value will be retrieved.
* @param ns_prefix Namespace prefix.
* @return The text value of the attribute, or an empty string if no such attribute was found.
*
* @newin{2,20}
*/
Glib::ustring get_attribute_value(const Glib::ustring& name,
const Glib::ustring& ns_prefix = Glib::ustring()) const;
/** 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.
* @param name The name of the attribute whose value will change.
* @param value The new value for the attribute
* @param ns_prefix Namespace prefix. If the prefix has not been declared then this method will throw an exception.
* @return The attribute that was changed, or 0 is no suitable Attribute was found.
*/
Attribute* set_attribute(const Glib::ustring& name, const Glib::ustring& value,
const Glib::ustring& ns_prefix = Glib::ustring());
/** Remove the attribute with this name, and optionally with this namespace.
* @param name The name of the attribute to be removed
* @param ns_prefix Namespace prefix. If specified, the attribute will be removed only if the attribute has this namespace.
*/
void remove_attribute(const Glib::ustring& name,
const Glib::ustring& ns_prefix = Glib::ustring());
/** 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.
*/
TextNode* 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* get_child_text() const;
/** Append a new text node.
* @param content The text. This should be unescaped - see ContentNode::set_content().
* @returns The new text node.
*/
TextNode* add_child_text(const Glib::ustring& content = Glib::ustring());
/** Add a new text node after the specified existing child node.
*
* @newin{2,24}
*
* @param previous_sibling An existing child node.
* @param content The text. This should be unescaped - see ContentNode::set_content().
* @returns The new text node.
*/
TextNode* add_child_text(xmlpp::Node* previous_sibling, const Glib::ustring& content = Glib::ustring());
/** Add a new text node before the specified existing child node.
*
* @newin{2,24}
*
* @param next_sibling An existing child node.
* @param content The text. This should be unescaped - see ContentNode::set_content().
* @returns The new text node.
*/
TextNode* add_child_text_before(xmlpp::Node* next_sibling, const Glib::ustring& content = Glib::ustring());
/** 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.
* @param content The text. This should be unescaped - see ContentNode::set_content().
*/
void set_child_text(const Glib::ustring& content);
/** 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.
*/
bool has_child_text() const;
/** Append a new comment node.
* @param content The text. This should be unescaped - see ContentNode::set_content().
* @returns The new comment node.
*/
CommentNode* add_child_comment(const Glib::ustring& content);
/** Append a new CDATA node.
* @param content The raw text.
* @returns The new CDATA node.
*/
CdataNode* add_child_cdata(const Glib::ustring& content);
protected:
Glib::ustring get_namespace_uri_for_prefix(const Glib::ustring& ns_prefix) const;
};
} // namespace xmlpp
#endif //__LIBXMLPP_NODES_ELEMENT_H
|