Add another conversion.
[libcxml.git] / src / cxml.h
index c9f1065060f5e5edad983fdc8c7bdd50590874ab..20a948ae29e920a5204e37cb2b91b53b0fb9a1d8 100644 (file)
@@ -1,14 +1,38 @@
+/*
+    Copyright (C) 2012-2019 Carl Hetherington <cth@carlh.net>
+
+    This file is part of libcxml.
+
+    libcxml is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    libcxml is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with libcxml.  If not, see <http://www.gnu.org/licenses/>.
+
+*/
+
 #ifndef LIBCXML_CXML_H
 #define LIBCXML_CXML_H
 
-#include <string>
-#include <list>
-#include <stdint.h>
 #include <boost/shared_ptr.hpp>
 #include <boost/optional.hpp>
-#include <boost/lexical_cast.hpp>
+#include <boost/filesystem.hpp>
 #include <boost/algorithm/string/erase.hpp>
-#include <glibmm.h>
+#include <stdint.h>
+#include <string>
+#include <list>
+
+/* Hack for OS X compile failure; see https://bugs.launchpad.net/hugin/+bug/910160 */
+#ifdef check
+#undef check
+#endif
 
 namespace xmlpp {
        class Node;
@@ -41,17 +65,50 @@ private:
        std::string _message;
 };
 
+/** A sort-of version of boost::lexical_cast that does uses the "C"
+ *  locale (i.e. no thousands separators and a . for the decimal separator).
+ */
+template <typename P, typename Q>
+P
+raw_convert (Q v)
+{
+       /* We can't write a generic version of raw_convert; all required
+          versions must be specialised.
+       */
+       BOOST_STATIC_ASSERT (sizeof(Q) == 0);
+}
+
+template <>
+int
+raw_convert (std::string v);
+
+template <>
+unsigned int
+raw_convert (std::string v);
+
+template <>
+long int
+raw_convert (std::string v);
+
+template <>
+float
+raw_convert (std::string v);
+
+template <>
+double
+raw_convert (std::string v);
+
 /** @brief A wrapper for a xmlpp::Node which simplifies parsing */
 class Node
 {
 public:
        Node ();
-       
+
        /** Construct a Node from an xmlpp::Node.  This class will
         *  not destroy the xmlpp::Node.
         *  @param node xmlpp::Node.
         */
-       Node (xmlpp::Node const * node);
+       Node (xmlpp::Node* node);
 
        std::string name () const;
 
@@ -66,7 +123,7 @@ public:
         * </Fred>
         *
         * string_child ("Jim") would return "42"
-        * numerical_child<int64_t> ("Jim") would return 42.
+        * number_child<int64_t> ("Jim") would return 42.
         * ...and so on.
         *
         * The methods not marked "optional" will throw an exception
@@ -84,15 +141,15 @@ public:
        boost::optional<bool> optional_bool_child (std::string) const;
 
        template <class T>
-       T numerical_child (std::string c) const
+       T number_child (std::string c) const
        {
                std::string s = string_child (c);
                boost::erase_all (s, " ");
-               return boost::lexical_cast<T> (s);
+               return raw_convert<T> (s);
        }
 
        template <class T>
-       boost::optional<T> optional_numerical_child (std::string c) const
+       boost::optional<T> optional_number_child (std::string c) const
        {
                boost::optional<std::string> s = optional_string_child (c);
                if (!s) {
@@ -101,9 +158,9 @@ public:
 
                std::string t = s.get ();
                boost::erase_all (t, " ");
-               return boost::optional<T> (boost::lexical_cast<T> (t));
+               return raw_convert<T> (t);
        }
-               
+
        /** This will mark a child as to be ignored when calling done() */
        void ignore_child (std::string) const;
 
@@ -123,15 +180,15 @@ public:
        boost::optional<bool> optional_bool_attribute (std::string) const;
 
        template <class T>
-       T numerical_attribute (std::string c) const
+       T number_attribute (std::string c) const
        {
                std::string s = string_attribute (c);
                boost::erase_all (s, " ");
-               return boost::lexical_cast<T> (s);
+               return raw_convert<T> (s);
        }
 
        template <class T>
-       boost::optional<T> optional_numerical_attribute (std::string c) const
+       boost::optional<T> optional_number_attribute (std::string c) const
        {
                boost::optional<std::string> s = optional_string_attribute (c);
                if (!s) {
@@ -140,32 +197,59 @@ public:
 
                std::string t = s.get ();
                boost::erase_all (t, " ");
-               return boost::optional<T> (boost::lexical_cast<T> (t));
+               return raw_convert<T> (t);
        }
 
-       /** @return The content of this node */
+       /** @return The text content of this node (excluding comments or CDATA) */
        std::string content () const;
 
+       /** @return namespace URI of this node */
+       std::string namespace_uri () const;
+
+       /** @return namespace prefix of this node */
+       std::string namespace_prefix () const;
+
        boost::shared_ptr<Node> node_child (std::string) const;
        boost::shared_ptr<Node> optional_node_child (std::string) const;
 
+       std::list<boost::shared_ptr<Node> > node_children () const;
        std::list<boost::shared_ptr<Node> > node_children (std::string) const;
-       
+
+       xmlpp::Node* node () const {
+               return _node;
+       }
+
 protected:
-       xmlpp::Node const * _node;
-       
+       xmlpp::Node* _node;
+
 private:
-       mutable std::list<Glib::ustring> _taken;
+       mutable std::list<std::string> _taken;
 };
 
-class File : public Node
+typedef boost::shared_ptr<cxml::Node> NodePtr;
+typedef boost::shared_ptr<const cxml::Node> ConstNodePtr;
+
+class Document : public Node
 {
 public:
-       File (std::string file, std::string root_name);
-       virtual ~File ();
+       Document ();
+       Document (std::string root_name);
+       Document (std::string root_name, boost::filesystem::path);
+
+       virtual ~Document ();
+
+       void read_file (boost::filesystem::path);
+       void read_string (std::string);
+
+       std::string root_name () const {
+               return _root_name;
+       }
 
 private:
+       void take_root_node ();
+
        xmlpp::DomParser* _parser;
+       std::string _root_name;
 };
 
 }