/usr/include/libxml++-2.6/libxml++/nodes/element.h is in libxml++2.6-dev 2.36.0-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 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 | /* 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>
#include <libxml++/nodes/textnode.h>
#include <libxml++/nodes/processinginstructionnode.h>
#include <libxml++/nodes/entityreference.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.
* @throws xmlpp::exception If a new namespace node cannot be created,
* e.g. because a namespace with the same prefix but another URI already exists.
*/
void set_namespace_declaration(const Glib::ustring& ns_uri, const Glib::ustring& ns_prefix = Glib::ustring());
/** Obtain the list of explicitly set attributes for this element.
* @returns The list of explicitly set attributes.
*/
AttributeList get_attributes();
/** Obtain the list of explicitly set attributes for this element.
* @returns The list of explicitly set 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
/** Get the attribute with this name, and optionally with this namespace.
* @param name The name of the attribute that will be retrieved.
* @param ns_prefix Namespace prefix.
* @return The attribute, or 0 if no suitable Attribute was found.
* Is either an AttributeNode*, pointing to an explicitly set
* attribute, or an AttributeDeclaration*, pointing to the declaration
* of an attribute with a default value.
*/
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.
* @throws xmlpp::exception
*/
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.
* @throws xmlpp::internal_error
*/
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.
* @throws xmlpp::internal_error
*/
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.
* @throws xmlpp::internal_error
*/
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().
* @throws xmlpp::internal_error
*/
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.
* @throws xmlpp::internal_error
*/
CommentNode* add_child_comment(const Glib::ustring& content);
/** Append a new CDATA node.
* @param content The raw text.
* @returns The new CDATA node.
* @throws xmlpp::internal_error
*/
CdataNode* add_child_cdata(const Glib::ustring& content);
/** Append a new entity reference node.
* The reference can be either an entity reference ("name" or "&name;") or
* a character reference ("#dec", "#xhex", "&#dec;", or "&#xhex;").
*
* '&' and ';' are optional. If they exist, they are stripped from the stored
* copy of the name. Node::get_name() returns the name without '&' and ';'.
* If the Document is written to an XML file, '&' and ';' are written.
*
* @newin{2,36}
*
* @param name The name of the entity.
* @returns The new entity reference node.
* @throws xmlpp::internal_error
*/
EntityReference* add_child_entity_reference(const Glib::ustring& name);
/** Append a new processing instruction node.
*
* @newin{2,36}
*
* @param name The name of the application to which the instruction is directed.
* @param content The content of the instruction. This should be unescaped - see ContentNode::set_content().
* @returns The new processing instruction node.
* @throws xmlpp::internal_error
*/
ProcessingInstructionNode* add_child_processing_instruction(
const Glib::ustring& name, 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
|