Imported Upstream version 2.91.2

[platform/upstream/libxml++.git] / libxml++ / exceptions / exception.h

diff --git a/libxml++/exceptions/exception.h b/libxml++/exceptions/exception.h
index 4510075..7fbaf1e 100644 (file)
--- a/libxml++/exceptions/exception.h
+++ b/libxml++/exceptions/exception.h
@@ -21,6 +21,7 @@
 #define __LIBXMLPP_EXCEPTION_H
 
 #include <exception>
+#include <cstdarg> // va_list
 #include <glibmm/ustring.h>
 
 #include <libxml++config.h>
@@ -43,6 +44,9 @@ public:
 
   const char* what() const noexcept override;
 
+  virtual void raise() const;
+  virtual exception* clone() const;
+
 private:
   Glib::ustring message_;
 };
@@ -51,8 +55,8 @@ private:
  *
  * @newin{2,36}
  *
- * @param error Pointer to an _xmlError struct or <tt>0</tt>. If <tt>0</tt>,
- *              the error returned by xmlGetLastError() is used.
+ * @param error Pointer to an _xmlError struct or <tt>nullptr</tt>.
+ *              If <tt>nullptr</tt>, the error returned by xmlGetLastError() is used.
  * @returns A formatted text string. If the error struct does not contain an
  *          error (error->code == XML_ERR_OK), an empty string is returned.
  */
@@ -69,6 +73,27 @@ Glib::ustring format_xml_error(const _xmlError* error = nullptr);
  */
 Glib::ustring format_xml_parser_error(const _xmlParserCtxt* parser_context);
 
+/** Format a message from a function with C-style variadic parameters.
+ *
+ * Helper function that formats a message supplied in the form of a printf-style
+ * format specification and zero or more ... parameters.
+ *
+ * @code
+ * // Typical call:
+ * void f(const char* fmt, ...)
+ * {
+ *   va_list args;
+ *   va_start(args, fmt);
+ *   Glib::ustring msg = xmlpp::format_printf_message(fmt, args);
+ *   va_end(args);
+ *   // ...
+ * }
+ * @endcode
+ *
+ * @newin{3,0}
+ */
+Glib::ustring format_printf_message(const char* fmt, va_list args);
+
 } // namespace xmlpp
 
 #endif // __LIBXMLPP_EXCEPTION_H