/usr/include/libxml++-2.6/libxml++/nodes/node.h is in libxml++2.6-dev 2.34.1-1build1.
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 198 199 200 201 202 203 204 205 206 207 208 209 | /* node.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_NODE_H
#define __LIBXMLPP_NODES_NODE_H
#include <libxml++/noncopyable.h>
#include <libxml++/exceptions/exception.h>
#include <glibmm/ustring.h>
#include <list>
#include <map>
#include <vector>
#ifndef DOXYGEN_SHOULD_SKIP_THIS
extern "C" {
struct _xmlNode;
}
#endif //DOXYGEN_SHOULD_SKIP_THIS
namespace xmlpp
{
class TextNode;
class Element;
class Attribute;
class Node;
typedef std::vector<Node*> NodeSet;
/** Represents XML Nodes.
* You should never new or delete Nodes. The Parser will create and manage them for you.
*/
class Node : public NonCopyable
{
public:
typedef std::list<Node*> NodeList;
explicit Node(_xmlNode* node);
virtual ~Node();
/** Get the name of this node.
* @returns The node's name.
*/
Glib::ustring get_name() const;
/** Set the name of this node.
* @param name The new name for the node.
*/
void set_name(const Glib::ustring& name);
/** Set the namespace prefix used by the node.
* If no such namespace prefix has been declared then this method will throw an exception.
* @param ns_prefix The namespace prefix.
*/
void set_namespace(const Glib::ustring& ns_prefix);
Glib::ustring get_namespace_prefix() const;
Glib::ustring get_namespace_uri() const;
/** Discover at what line number this node occurs in the XML file.
* @returns The line number.
*/
int get_line() const;
/** Get the parent element for this node.
* @returns The parent node
*/
const Element* get_parent() const;
/** Get the parent element for this node.
* @returns The parent node
*/
Element* get_parent();
/** Get the next sibling for this node.
* @returns The next sibling
*/
const Node* get_next_sibling() const;
/** Get the next sibling for this node.
* @returns The next sibling
*/
Node* get_next_sibling();
/** Get the previous sibling for this node .
* @returns The previous sibling
*/
const Node* get_previous_sibling() const;
/** Get the previous sibling for this node.
* @returns The previous sibling
*/
Node* get_previous_sibling();
/** Obtain the list of child nodes. You may optionally obtain a list of only the child nodes which have a certain name.
* @param name The names of the child nodes to get. If you do not specigy a name, then the list will contain all nodes, regardless of their names.
* @returns The list of child nodes.
*/
NodeList get_children(const Glib::ustring& name = Glib::ustring());
/** Obtain the list of child nodes. You may optionally obtain a list of only the child nodes which have a certain name.
* @param name The names of the child nodes to get. If you do not specigy a name, then the list will contain all nodes, regardless of their names.
* @returns The list of child nodes.
*/
const NodeList get_children(const Glib::ustring& name = Glib::ustring()) const;
/** Add a child element to this node.
* @param name The new node name
* @param ns_prefix The namespace prefix. If the prefix has not been declared then this method will throw an exception.
* @returns The newly-created element
*/
Element* add_child(const Glib::ustring& name,
const Glib::ustring& ns_prefix = Glib::ustring());
/** Add a child element to this node after the specified existing child node.
*
* @newin{2,24}
*
* @param previous_sibling An existing child node.
* @param name The new node name
* @param ns_prefix The namespace prefix. If the prefix has not been declared then this method will throw an exception.
* @returns The newly-created element
*/
Element* add_child(xmlpp::Node* previous_sibling, const Glib::ustring& name,
const Glib::ustring& ns_prefix = Glib::ustring());
/** Add a child element to this node before the specified existing child node.
*
* @newin{2,24}
*
* @param next_sibling An existing child node.
* @param name The new node name
* @param ns_prefix The namespace prefix. If the prefix has not been declared then this method will throw an exception.
* @returns The newly-created element
*/
Element* add_child_before(xmlpp::Node* next_sibling, const Glib::ustring& name,
const Glib::ustring& ns_prefix = Glib::ustring());
/** Remove the child node.
* @param node The child node to remove. This Node will be deleted and therefore unusable after calling this method.
*/
void remove_child(Node* node);
/** Import node(s) from another document under this node, without affecting the source node.
* @param node The node to copy and insert under the current node.
* @param recursive Whether to import the child nodes also. Defaults to true.
* @returns The newly-created node.
*/
Node* import_node(const Node* node, bool recursive = true);
/** Return the XPath of this node.
* @result The XPath of the node.
*/
Glib::ustring get_path() const;
/** Find nodes from a XPath expression.
* @param xpath The XPath of the nodes.
*/
NodeSet find(const Glib::ustring& xpath) const;
/** A map of namespace prefixes to namespace URIs.
*/
typedef std::map<Glib::ustring, Glib::ustring> PrefixNsMap;
/** Find nodes from a XPath expression.
* @param xpath The XPath of the nodes.
* @param namespaces A map of namespace prefixes to namespace URIs to be used while finding.
*/
NodeSet find(const Glib::ustring& xpath, const PrefixNsMap& namespaces) const;
///Access the underlying libxml implementation.
_xmlNode* cobj();
///Access the underlying libxml implementation.
const _xmlNode* cobj() const;
/** Construct the correct C++ instance for a given libxml C struct instance.
*
* This is only for use by the libxml++ implementation.
*
* @para node A pointer to an xmlNode or a "derived" struct, such as xmlDoc, xmlAttr, etc.
*/
static void create_wrapper(_xmlNode* node);
/** Delete the C++ instance for a given libxml C struct instance, and also
* recursively destroy the C++ instances for any children.
*
* This is only for use by the libxml++ implementation.
* @para node A pointer to an xmlNode or a "derived" struct, such as xmlDoc, xmlAttr, etc.
*/
static void free_wrappers(_xmlNode* attr);
protected:
///Create the C instance ready to be added to the parent node.
_xmlNode* create_new_child_node(const Glib::ustring& name, const Glib::ustring& ns_prefix);
private:
_xmlNode* impl_;
};
} // namespace xmlpp
#endif //__LIBXMLPP_NODES_NODE_H
|