fixed potential ODR issues relating to exception mode handling (fixes #6)

also:
- fixed truncation of floating-point values when using ostreams
- fixed some minor documentation issues (fixes #8)
- fixed missing value deduction guides for dates and times
- added serialization round-trip tests (closes #9)
- added node::is_number()
- added node_view::is_number()
- added node_view::value_or() (closes #7)
- added hexfloat parsing support for all implementations, not just <charconv> ones

Author: marzer

README.md

@@ -5,6 +5,13 @@
 [![GitHub](https://img.shields.io/github/license/marzer/tomlplusplus)](https://github.com/marzer/tomlplusplus/blob/master/LICENSE)  
 
 `toml++` is a header-only toml parser and serializer for C++17, C++20 and whatever comes after.
+ - Fully [TOML v0.5.0]-compliant
+ - Modern C++17 (with some C++20 features where supported)
+ - Proper UTF-8 handling (incl. BOM)
+ - Works with or without exceptions
+ - Doesn't require RTTI
+ - First-class support for serializing to JSON
+ - Supports a number of 'unreleased' TOML features (optional)
 
 <br>
 
@@ -25,10 +32,10 @@ Reading it in C++ is easy with `toml++`:
 auto config = toml::parse_file( "configuration.toml" );
 
 // get key-value pairs
-std::string_view library_name = config["library"]["name"].as_string()->get();
-std::string_view library_version = config["library"]["version"].as_string()->get();
-std::string_view library_author = config["library"]["authors"][0].as_string()->get();
-int64_t depends_on_cpp_version = config["dependencies"]["cpp"].as_integer()->get();
+std::string_view library_name = config["library"]["name"].value_or(""sv);
+std::string_view library_version = config["library"]["version"].value_or(""sv);
+std::string_view library_author = config["library"]["authors"][0].value_or(""sv);
+int64_t depends_on_cpp_version = config["dependencies"]["cpp"].value_or(0);
 
 // modify the data
 config.insert_or_assign("alternatives", toml::array{
@@ -80,7 +87,7 @@ won't need to mess with these at all, butif you do, set them before including to
 | Option                     |      Type      | Default                           | Description                                                                                              |
 |----------------------------|:--------------:|-----------------------------------|----------------------------------------------------------------------------------------------------------|
 | `TOML_ASSERT(expr)`        | function macro | `assert(expr)`<br>(or undefined)  | Sets the assert function used by the library.                                                            |
-| `TOML_CHAR_8_STRINGS`      |     boolean    | `0`                               | Uses C++20 [char8_t]-based strings as the toml string data type.                                         |
+| `TOML_CHAR_8_STRINGS`      |     boolean    | `0`                               | Uses C++20 [char8_t]-based strings as the toml string data type. **_Experimental!_**                   |
 | `TOML_CONFIG_HEADER`       | string literal | undefined                         | Includes the given header file before the rest of the library.                                           |
 | `TOML_LARGE_FILES`         |     boolean    | `0`                               | Uses 32-bit integers for line and column indices (instead of 16-bit).                                    |
 | `TOML_SMALL_FLOAT_TYPE`    |    type name   | undefined                         | If your codebase has an additional 'small' float type (e.g. half-precision), this tells toml++ about it. |

docs/Doxyfile

@@ -339,6 +339,9 @@ PREDEFINED             = TOML_DOXYGEN=1 \
 						 TOML_ALWAYS_INLINE=inline \
 						 TOML_MAY_THROW= \
 						 TOML_NODISCARD_CTOR= \
+						 TOML_ASYMMETRICAL_EQUALITY_OPS= \
+						 TOML_START="namespace toml" \
+						 TOML_END= \
 						 __cpp_lib_char8_t=201811L
 EXPAND_AS_DEFINED      = 
 SKIP_FUNCTION_MACROS   = NO

examples/parse_file.cpp

@@ -1,6 +1,6 @@
-#include <toml++/toml.h>
 #include <iostream>
 #include <fstream>
+#include <toml++/toml.h>
 #ifdef _WIN32
 #define WIN32_LEAN_AND_MEAN
 #include <Windows.h>
@@ -22,9 +22,8 @@ int main(int argc, char** argv)
 	}
 	try
 	{
-		const auto table = toml::parse(file, std::move(path));
-
-		std::cout << table << std::endl;
+		const auto tbl = toml::parse(file, std::move(path));
+		std::cout << tbl << std::endl;
 	}
 	catch (const toml::parse_error& err)
 	{

examples/toml_to_json_transcoder.cpp

@@ -1,6 +1,6 @@
-#include <toml++/toml.h>
 #include <iostream>
 #include <fstream>
+#include <toml++/toml.h>
 #ifdef _WIN32
 #define WIN32_LEAN_AND_MEAN
 #include <Windows.h>

include/toml++/toml.h

@@ -20,7 +20,6 @@
 
 // macro hygiene
 #if TOML_UNDEF_MACROS
-	#undef TOML_EXCEPTIONS
 	#undef TOML_USE_STREAMS_FOR_FLOATS
 	#undef TOML_GCC_ATTR
 	#undef TOML_PUSH_WARNINGS
@@ -54,6 +53,10 @@
 	#undef TOML_DOXYGEN
 	#undef TOML_RELOPS_REORDERING
 	#undef TOML_ASYMMETRICAL_EQUALITY_OPS
+	#undef TOML_START
+	#undef TOML_END
+	#undef TOML_IMPL_START
+	#undef TOML_IMPL_END
 #endif
 
 /// \mainpage toml++
@@ -126,7 +129,7 @@
 /// 
 /// \ecpp
 /// 
-/// When exceptions are disabled parsing methods return a toml::parse_error and it is up to the caller
+/// When exceptions are disabled parsing methods return a toml::parse_result and it is up to the caller
 /// to check if parsing has been successful by examining the return value:
 /// \cpp
 /// #include <iostream>
@@ -151,7 +154,11 @@
 /// 	return 0;
 /// }
 /// \ecpp
-/// \see toml::parse_file()
+/// 
+/// \see
+///		- toml::parse_file()  
+///		- toml::parse_result  
+///		- toml::parse_error
 /// 
 ///////////////////////////////////
 /// 
@@ -189,7 +196,7 @@
 /// name = "toml++"
 /// version = "0.1.0"
 /// \eout
-/// \see toml::parse()
+/// \see toml::parse()  
 /// 
 ///////////////////////////////////
 /// 
@@ -252,7 +259,11 @@
 /// 'dinosaurs':
 /// \eout
 /// 
-/// \see toml::node, toml::node_view, toml::array, toml::table
+/// \see
+/// 	- toml::node
+/// 	- toml::node_view
+/// 	- toml::array
+/// 	- toml::table
 /// 
 ///////////////////////////////////
 /// 
@@ -317,7 +328,9 @@
 ///     ]
 /// }
 /// \eout
-/// \see toml::default_formatter, toml::json_formatter
+/// \see
+///		- toml::default_formatter
+///		- toml::json_formatter
 /// 
 ///////////////////////////////////////////////////////////////////////
 /// 

include/toml++/toml_array.h

@@ -1,7 +1,7 @@
 #pragma once
 #include "toml_value.h"
 
-namespace toml::impl
+TOML_IMPL_START
 {
 	template <bool is_const>
 	class array_iterator final
@@ -174,8 +174,9 @@ namespace toml::impl
 		}
 	}
 }
+TOML_IMPL_END
 
-namespace toml
+TOML_START
 {
 	[[nodiscard]] bool operator == (const table& lhs, const table& rhs) noexcept;
 
@@ -945,3 +946,4 @@ namespace toml
 			friend inline std::basic_ostream<CHAR>& operator << (std::basic_ostream<CHAR>&, const array&) TOML_MAY_THROW;
 	};
 }
+TOML_END

include/toml++/toml_common.h

@@ -229,6 +229,17 @@
 		__VA_ARGS__ [[nodiscard]] friend bool operator != (RHS rhs, LHS lhs) noexcept { return !(lhs == rhs); }
 #endif
 
+#if !TOML_DOXYGEN
+	#if TOML_EXCEPTIONS
+		#define TOML_START	namespace toml { inline namespace wex
+	#else
+		#define TOML_START	namespace toml { inline namespace woex
+	#endif
+	#define TOML_END			}
+#endif
+#define TOML_IMPL_START			TOML_START { namespace impl
+#define TOML_IMPL_END			} TOML_END
+
 #include "toml_version.h"
 
 #define TOML_MAKE_VERSION(maj, min, rev)											\
@@ -292,7 +303,9 @@ TOML_POP_WARNINGS
 // clang-format on
 
 /// \brief	The root namespace for all toml++ functions and types.
-namespace toml
+namespace toml { }
+
+TOML_START
 {
 	using namespace std::string_literals;
 	using namespace std::string_view_literals;
@@ -621,9 +634,9 @@ namespace toml
 
 	TOML_POP_WARNINGS
 }
+TOML_END
 
-/// \brief	Internal implementation details. No user-serviceable parts within.
-namespace toml::impl
+TOML_IMPL_START
 {
 	template <typename T>
 	using string_map = std::map<string, T, std::less<>>; //heterogeneous lookup
@@ -840,8 +853,9 @@ namespace toml::impl
 
 	#undef TOML_P2S_DECL
 }
+TOML_IMPL_END
 
-namespace toml
+TOML_START
 {
 	/// \brief	Metafunction for determining if a type is a toml::table.
 	template <typename T>
@@ -905,3 +919,4 @@ namespace toml
 		}
 	}
 }
+TOML_END

include/toml++/toml_date_time.h

@@ -1,7 +1,7 @@
 #pragma once
 #include "toml_common.h"
 
-namespace toml
+TOML_START
 {
 	/// \brief	A local date.
 	struct date final
@@ -301,3 +301,4 @@ namespace toml
 		}
 	};
 }
+TOML_END

include/toml++/toml_default_formatter.h

@@ -4,7 +4,7 @@
 #include "toml_array.h"
 #include "toml_utf8.h"
 
-namespace toml::impl
+TOML_IMPL_START
 {
 	TOML_PUSH_WARNINGS
 	TOML_DISABLE_ALL_WARNINGS
@@ -131,8 +131,9 @@ namespace toml::impl
 		return (default_formatter_inline_columns(node) + starting_column_bias) > 120_sz;
 	}
 }
+TOML_IMPL_END
 
-namespace toml
+TOML_START
 {
 	/// \brief	A wrapper for printing TOML objects out to a stream as formatted TOML.
 	/// 
@@ -494,3 +495,4 @@ namespace toml
 		return lhs << default_formatter<CHAR>{ rhs };
 	}
 }
+TOML_END

include/toml++/toml_formatter.h

@@ -1,7 +1,7 @@
 #pragma once
 #include "toml_print_to_stream.h"
 
-namespace toml
+TOML_START
 {
 	/// \brief	Format flags for modifying how TOML data is printed to streams.
 	enum class format_flags : uint8_t
@@ -18,8 +18,9 @@ namespace toml
 		return static_cast<format_flags>( impl::unbox_enum(lhs) | impl::unbox_enum(rhs) );
 	}
 }
+TOML_END
 
-namespace toml::impl
+TOML_IMPL_START
 {
 	template <typename CHAR = char>
 	class formatter
@@ -142,3 +143,4 @@ namespace toml::impl
 			{}
 	};
 }
+TOML_IMPL_END