From c3abf834264d683a098bbc0638a34b35f359c929 Mon Sep 17 00:00:00 2001 From: Nikita Kniazev Date: Wed, 31 Aug 2016 17:37:50 +0300 Subject: [PATCH 001/163] Suppress weak vtables warning --- include/boost/optional/bad_optional_access.hpp | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/include/boost/optional/bad_optional_access.hpp b/include/boost/optional/bad_optional_access.hpp index cabf43fb..add78675 100644 --- a/include/boost/optional/bad_optional_access.hpp +++ b/include/boost/optional/bad_optional_access.hpp @@ -19,6 +19,11 @@ namespace boost { +#if defined(__clang__) +# pragma clang diagnostic push +# pragma clang diagnostic ignored "-Wweak-vtables" +#endif + class bad_optional_access : public std::logic_error { public: @@ -27,6 +32,10 @@ class bad_optional_access : public std::logic_error {} }; +#if defined(__clang__) +# pragma clang diagnostic pop +#endif + } // namespace boost #endif From cd4e44f3dc66a24c49ac4dc7d176cff98bcca821 Mon Sep 17 00:00:00 2001 From: Matt Date: Thu, 13 Apr 2017 09:13:26 -0400 Subject: [PATCH 002/163] r #12967 make none_t constructor constexpr --- include/boost/none_t.hpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/include/boost/none_t.hpp b/include/boost/none_t.hpp index 008f369d..9ed94094 100644 --- a/include/boost/none_t.hpp +++ b/include/boost/none_t.hpp @@ -29,7 +29,7 @@ class none_t {}; struct none_t { struct init_tag{}; - explicit none_t(init_tag){} // to disable default constructor + explicit constexpr none_t(init_tag){} // to disable default constructor }; #endif // old implementation workarounds From b709447922e48e857d442856465a752312d54c2e Mon Sep 17 00:00:00 2001 From: Matt Date: Wed, 16 Aug 2017 13:52:46 -0400 Subject: [PATCH 003/163] r #12967 use BOOST_CONSTEXPR on none_t ctor --- include/boost/none_t.hpp | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/include/boost/none_t.hpp b/include/boost/none_t.hpp index 9ed94094..6b3c8334 100644 --- a/include/boost/none_t.hpp +++ b/include/boost/none_t.hpp @@ -13,6 +13,8 @@ #ifndef BOOST_NONE_T_17SEP2003_HPP #define BOOST_NONE_T_17SEP2003_HPP +#include + namespace boost { #ifdef BOOST_OPTIONAL_USE_OLD_DEFINITION_OF_NONE @@ -29,7 +31,7 @@ class none_t {}; struct none_t { struct init_tag{}; - explicit constexpr none_t(init_tag){} // to disable default constructor + explicit BOOST_CONSTEXPR none_t(init_tag){} // to disable default constructor }; #endif // old implementation workarounds From 4fbb7582e1774b1d6ef29e27b77aca3e9a3df368 Mon Sep 17 00:00:00 2001 From: Casey Carter Date: Wed, 18 Dec 2019 17:51:51 -0800 Subject: [PATCH 004/163] Don't instantiate is_convertible_to_T_or_factory when is_optional_related Fixes #78. --- include/boost/optional/optional.hpp | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 92df93d6..aadc975a 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -777,7 +777,7 @@ class optional_base : public optional_tag #include -// definition of metafunciton is_optional_val_init_candidate +// definition of metafunction is_optional_val_init_candidate template struct is_optional_related : boost::conditional< boost::is_base_of::type>::value @@ -813,9 +813,14 @@ struct is_optional_constructible : boost::true_type #endif // is_convertible condition -template +template ::value> struct is_optional_val_init_candidate - : boost::conditional< !is_optional_related::value && is_convertible_to_T_or_factory::value + : boost::false_type +{}; + +template +struct is_optional_val_init_candidate + : boost::conditional< is_convertible_to_T_or_factory::value , boost::true_type, boost::false_type>::type {}; From 9ed20cb0854120f76d4ccc0f9821c38553574f7e Mon Sep 17 00:00:00 2001 From: Andrey Semashev Date: Tue, 29 Oct 2019 21:21:03 +0300 Subject: [PATCH 005/163] Marked none instances as inline variables. This should avoid duplicating none instances in all translation units. Closes https://github.com/boostorg/optional/issues/33. --- include/boost/none.hpp | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/include/boost/none.hpp b/include/boost/none.hpp index a37c45c5..b5df2143 100644 --- a/include/boost/none.hpp +++ b/include/boost/none.hpp @@ -13,6 +13,7 @@ #ifndef BOOST_NONE_17SEP2003_HPP #define BOOST_NONE_17SEP2003_HPP +#include "boost/config.hpp" #include "boost/none_t.hpp" // NOTE: Borland users have to include this header outside any precompiled headers @@ -23,7 +24,7 @@ namespace boost { #ifdef BOOST_OPTIONAL_USE_OLD_DEFINITION_OF_NONE -none_t const none = (static_cast(0)) ; +BOOST_INLINE_VARIABLE none_t const none = (static_cast(0)) ; #elif defined BOOST_OPTIONAL_USE_SINGLETON_DEFINITION_OF_NONE @@ -35,7 +36,7 @@ namespace detail { namespace optional_detail { { static const T instance; }; - + template const T none_instance::instance = T(); // global, but because 'tis a template, no cpp file required @@ -49,7 +50,7 @@ namespace { #else -const none_t none ((none_t::init_tag())); +BOOST_INLINE_VARIABLE const none_t none ((none_t::init_tag())); #endif // older definitions From 13bc27698e96fd6a8a8191b63ae14d6a5828d1bb Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Fri, 20 Dec 2019 00:18:52 +0100 Subject: [PATCH 006/163] Add test case for fix to issue #78 --- doc/91_relnotes.qbk | 4 ++ doc/html/boost_optional/relnotes.html | 31 ++++++++----- doc/html/index.html | 2 +- test/Jamfile.v2 | 1 + test/optional_test_path_assignment.cpp | 62 ++++++++++++++++++++++++++ 5 files changed, 88 insertions(+), 12 deletions(-) create mode 100644 test/optional_test_path_assignment.cpp diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index a29137ce..f19da24b 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -11,6 +11,10 @@ [section:relnotes Release Notes] +[heading Boost Release 1.73] + +* Fixed [@https://github.com/boostorg/optional/issues/78 issue #78]. + [heading Boost Release 1.69] * Remove deprecation mark from `reset()` method (without arguments). diff --git a/doc/html/boost_optional/relnotes.html b/doc/html/boost_optional/relnotes.html index 3d846966..600639ea 100644 --- a/doc/html/boost_optional/relnotes.html +++ b/doc/html/boost_optional/relnotes.html @@ -28,6 +28,15 @@

+ Boost + Release 1.73 +

+
+

+ Boost Release 1.69

@@ -45,7 +54,7 @@

- + Boost Release 1.68

@@ -62,7 +71,7 @@

- + Boost Release 1.67

@@ -76,7 +85,7 @@

- + Boost Release 1.66

@@ -94,7 +103,7 @@

- + Boost Release 1.63

@@ -118,7 +127,7 @@

- + Boost Release 1.62

@@ -126,7 +135,7 @@

Fixed Trac #12179.

- + Boost Release 1.61

@@ -169,7 +178,7 @@

- + Boost Release 1.60

@@ -180,7 +189,7 @@

#11203.

- + Boost Release 1.59

@@ -194,7 +203,7 @@

- + Boost Release 1.58

@@ -230,7 +239,7 @@

- + Boost Release 1.57

@@ -240,7 +249,7 @@

to fix C++03 compile error on logic_error("...")".

- + Boost Release 1.56

diff --git a/doc/html/index.html b/doc/html/index.html index 39d99e7b..9094ce06 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -145,7 +145,7 @@

- +

Last revised: November 08, 2018 at 17:44:53 GMT

Last revised: December 19, 2019 at 23:07:07 GMT
diff --git a/test/Jamfile.v2 b/test/Jamfile.v2 index 7936ad7b..a881d52a 100644 --- a/test/Jamfile.v2 +++ b/test/Jamfile.v2 @@ -50,6 +50,7 @@ import testing ; [ run optional_test_member_T.cpp ] [ run optional_test_tc_base.cpp ] [ compile optional_test_sfinae_friendly_ctor.cpp ] + [ compile optional_test_path_assignment.cpp ] [ compile-fail optional_test_fail_const_swap.cpp ] [ compile-fail optional_test_ref_convert_assign_const_int_prevented.cpp ] [ compile-fail optional_test_fail1.cpp ] diff --git a/test/optional_test_path_assignment.cpp b/test/optional_test_path_assignment.cpp new file mode 100644 index 00000000..6da67184 --- /dev/null +++ b/test/optional_test_path_assignment.cpp @@ -0,0 +1,62 @@ +// Copyright (C) 2019 Andrzej Krzemienski. +// +// Use, modification, and distribution is subject to the Boost Software +// License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at +// http://www.boost.org/LICENSE_1_0.txt) +// +// See http://www.boost.org/lib/optional for documentation. +// +// You are welcome to contact the author at: +// akrzemi1@gmail.com + +#include "boost/optional/optional.hpp" + +#ifdef __BORLANDC__ +#pragma hdrstop +#endif + +template +struct void_t +{ + typedef void type; +}; + + +template +struct trait +{ +}; + +// the following trait emulates properties std::iterator_traits +template +struct trait >::type + >::type> +{ + typedef BOOST_DEDUCED_TYPENAME T::value_type value_type; +}; + +// This class emulates the properties of std::filesystem::path +struct Path +{ + template ::value_type> + Path(T const&); +}; + + +int main() +{ +#ifndef BOOST_OPTIONAL_DETAIL_NO_IS_CONSTRUCTIBLE_TRAIT +#ifndef BOOST_OPTIONAL_DETAIL_NO_SFINAE_FRIENDLY_CONSTRUCTORS + + boost::optional optFs1; + boost::optional optFs2; + + optFs1 = optFs2; + + // the following still fails although it shouldn't + //BOOST_STATIC_ASSERT((std::is_copy_constructible>::value)); + +#endif +#endif +} From 010ee006040c19239af9d6ae7cfab4a2ac0279c7 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Fri, 20 Dec 2019 00:30:37 +0100 Subject: [PATCH 007/163] Update release notes --- doc/91_relnotes.qbk | 1 + doc/html/boost_optional/relnotes.html | 10 ++++++++-- doc/html/index.html | 2 +- 3 files changed, 10 insertions(+), 3 deletions(-) diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index f19da24b..b5be701d 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -14,6 +14,7 @@ [heading Boost Release 1.73] * Fixed [@https://github.com/boostorg/optional/issues/78 issue #78]. +* `boost::none` is now declared as an inline variable (on compilers taht support it): there is only one instance of `boost::none` across all translation units. [heading Boost Release 1.69] diff --git a/doc/html/boost_optional/relnotes.html b/doc/html/boost_optional/relnotes.html index 600639ea..333178d1 100644 --- a/doc/html/boost_optional/relnotes.html +++ b/doc/html/boost_optional/relnotes.html @@ -31,10 +31,16 @@

Boost Release 1.73

-
  • +
    +
    • +
  • + boost::none is now declared as an inline variable + (on compilers taht support it): there is only one instance of boost::none across all translation units. +
    • +

Boost diff --git a/doc/html/index.html b/doc/html/index.html index 9094ce06..0a5611fd 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -145,7 +145,7 @@

- +

Last revised: December 19, 2019 at 23:07:07 GMT

Last revised: December 19, 2019 at 23:27:43 GMT
From 683dbe24123d08519daf8ff492bbbed807ca6e17 Mon Sep 17 00:00:00 2001 From: Robert Leahy Date: Mon, 23 Dec 2019 11:22:25 -0500 Subject: [PATCH 008/163] .travis.yml: Specify Trusty for Trusty Addons Previously .travis.yml didn't specify dist: trusty when using addons which were specifically for Trusty. This led to the Clang 5 build failing when trying to install Clang 5. --- .travis.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.travis.yml b/.travis.yml index 2903ba19..b6055859 100644 --- a/.travis.yml +++ b/.travis.yml @@ -151,6 +151,7 @@ matrix: - llvm-toolchain-precise-3.9 - os: linux + dist: trusty compiler: clang++-4.0 env: TOOLSET=clang COMPILER=clang++-4.0 CXXSTD=03,11,14,1z addons: @@ -162,6 +163,7 @@ matrix: - llvm-toolchain-trusty-4.0 - os: linux + dist: trusty compiler: clang++-5.0 env: TOOLSET=clang COMPILER=clang++-5.0 CXXSTD=03,11,14,1z addons: From d07ae789013e4fa38622efff65113b6bbfb31a85 Mon Sep 17 00:00:00 2001 From: Robert Leahy Date: Sun, 22 Dec 2019 16:12:28 -0500 Subject: [PATCH 009/163] Tests Pass in GCC 4.4.7 Several tests either did not compile or failed upon running when using GCC 4.4.7. --- test/optional_test_constructible_from_other.cpp | 10 ++++++---- test/optional_test_path_assignment.cpp | 4 ++++ test/optional_test_ref_converting_ctor.cpp | 2 ++ 3 files changed, 12 insertions(+), 4 deletions(-) diff --git a/test/optional_test_constructible_from_other.cpp b/test/optional_test_constructible_from_other.cpp index e106b693..af856862 100644 --- a/test/optional_test_constructible_from_other.cpp +++ b/test/optional_test_constructible_from_other.cpp @@ -26,12 +26,14 @@ struct size_tag {}; template< typename T, typename U > struct is_constructible { - template< typename T1, typename U1 > - static yes_type check_helper(size_tag< sizeof(static_cast< T1 >(U1())) >*); - template< typename T1, typename U1 > + static U& get(); + + template< typename T1 > + static yes_type check_helper(size_tag< sizeof(static_cast< T1 >(get())) >*); + template< typename T1 > static no_type check_helper(...); - static const bool value = sizeof(check_helper< T, U >(0)) == sizeof(yes_type); + static const bool value = sizeof(check_helper< T >(0)) == sizeof(yes_type); }; template< typename T > diff --git a/test/optional_test_path_assignment.cpp b/test/optional_test_path_assignment.cpp index 6da67184..fa51fffd 100644 --- a/test/optional_test_path_assignment.cpp +++ b/test/optional_test_path_assignment.cpp @@ -15,6 +15,8 @@ #pragma hdrstop #endif +#ifndef BOOST_OPTIONAL_DETAIL_NO_IS_CONSTRUCTIBLE_TRAIT +#ifndef BOOST_OPTIONAL_DETAIL_NO_SFINAE_FRIENDLY_CONSTRUCTORS template struct void_t { @@ -42,6 +44,8 @@ struct Path template ::value_type> Path(T const&); }; +#endif +#endif int main() diff --git a/test/optional_test_ref_converting_ctor.cpp b/test/optional_test_ref_converting_ctor.cpp index 81f3c0f4..e31904b9 100644 --- a/test/optional_test_ref_converting_ctor.cpp +++ b/test/optional_test_ref_converting_ctor.cpp @@ -93,7 +93,9 @@ template void test_all_const_cases() { test_converting_ctor(); +#ifndef BOOST_OPTIONAL_CONFIG_NO_PROPER_CONVERT_FROM_CONST_INT test_converting_ctor(); +#endif test_converting_ctor_for_noconst_const(); } From 9581804efa0f658decab090a6914062ec826ec73 Mon Sep 17 00:00:00 2001 From: Robert Leahy Date: Sun, 22 Dec 2019 16:13:53 -0500 Subject: [PATCH 010/163] GCC 4.4.7: boost::in_place & Assignment Assigning a boost::in_place_factory to a boost::optional templated on a type which was trivially copyable failed to compile under GCC 4.4.7. --- .../optional/detail/optional_trivially_copyable_base.hpp | 2 +- test/optional_test_inplace_factory.cpp | 7 +++++++ 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/include/boost/optional/detail/optional_trivially_copyable_base.hpp b/include/boost/optional/detail/optional_trivially_copyable_base.hpp index 5a37eacf..2cabf9a7 100644 --- a/include/boost/optional/detail/optional_trivially_copyable_base.hpp +++ b/include/boost/optional/detail/optional_trivially_copyable_base.hpp @@ -359,7 +359,7 @@ class tc_optional_base : public optional_tag template void construct ( Expr const& factory, in_place_factory_base const* ) { - boost_optional_detail::construct(factory, m_storage.address()); + boost_optional_detail::construct(factory, boost::addressof(m_storage)); m_initialized = true ; } diff --git a/test/optional_test_inplace_factory.cpp b/test/optional_test_inplace_factory.cpp index 1e852f0a..b8c31307 100644 --- a/test/optional_test_inplace_factory.cpp +++ b/test/optional_test_inplace_factory.cpp @@ -63,6 +63,9 @@ void test_ctor() BOOST_TEST(og1_ == og1); BOOST_TEST(og1_ != og2); BOOST_TEST(og1_ != og0); + + boost::optional o( boost::in_place(5) ); + BOOST_TEST(o && (*o == 5)); #endif } @@ -92,6 +95,10 @@ void test_assign() BOOST_TEST(og1_ == og1); BOOST_TEST(og1_ != og2); BOOST_TEST(og1_ != og0); + + boost::optional o; + o = boost::in_place(5); + BOOST_TEST(o && (*o == 5)); #endif #endif } From d4a4a5b6ad6c69c28666731beddc7d8aa480b334 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 16 Jan 2020 22:31:23 +0100 Subject: [PATCH 011/163] fixed C++98-incompatible unit test --- test/optional_test_path_assignment.cpp | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/test/optional_test_path_assignment.cpp b/test/optional_test_path_assignment.cpp index 6da67184..f0c214a5 100644 --- a/test/optional_test_path_assignment.cpp +++ b/test/optional_test_path_assignment.cpp @@ -20,7 +20,7 @@ struct void_t { typedef void type; }; - + template struct trait @@ -29,7 +29,7 @@ struct trait // the following trait emulates properties std::iterator_traits template -struct trait >::type >::type> { @@ -39,13 +39,20 @@ struct trait= 201103 template ::value_type> Path(T const&); +#else + template + Path(T const&, BOOST_DEDUCED_TYPENAME trait::value_type* = 0); +#endif + }; int main() -{ +{ #ifndef BOOST_OPTIONAL_DETAIL_NO_IS_CONSTRUCTIBLE_TRAIT #ifndef BOOST_OPTIONAL_DETAIL_NO_SFINAE_FRIENDLY_CONSTRUCTORS From 78d6563bcee11020b1468dda3dab813cd0bfbf1e Mon Sep 17 00:00:00 2001 From: Edward Diener Date: Mon, 30 Mar 2020 14:04:35 -0400 Subject: [PATCH 012/163] Change __BORLANDC__ to BOOST_BORLANDC, which is defined in Boost config for the Embarcadero non-clang-based compilers. --- include/boost/optional/detail/old_optional_implementation.hpp | 4 ++-- include/boost/optional/detail/optional_config.hpp | 2 +- test/optional_ref_assign_test_defs.hpp | 2 +- test/optional_test.cpp | 2 +- test/optional_test_conversions_from_U.cpp | 2 +- test/optional_test_convert_from_T.cpp | 2 +- test/optional_test_emplace.cpp | 2 +- test/optional_test_empty_braces.cpp | 2 +- test/optional_test_equals_none.cpp | 2 +- test/optional_test_experimental_traits.cpp | 2 +- test/optional_test_flat_map.cpp | 2 +- test/optional_test_inplace_factory.cpp | 2 +- test/optional_test_inplace_fail.cpp | 2 +- test/optional_test_inplace_fail2.cpp | 2 +- test/optional_test_io.cpp | 2 +- test/optional_test_make_optional.cpp | 2 +- test/optional_test_map.cpp | 2 +- test/optional_test_maybe_uninitialized_warning.cpp | 2 +- test/optional_test_member_T.cpp | 2 +- test/optional_test_minimum_requirements.cpp | 2 +- test/optional_test_move.cpp | 2 +- test/optional_test_msvc_bug_workaround.cpp | 2 +- test/optional_test_noexcept_move.cpp | 2 +- test/optional_test_old_impl.cpp | 2 +- test/optional_test_path_assignment.cpp | 2 +- test/optional_test_ref_assign_const_int.cpp | 2 +- test/optional_test_ref_assign_mutable_int.cpp | 2 +- test/optional_test_ref_assign_portable_minimum.cpp | 2 +- test/optional_test_ref_convert_assign_const_int.cpp | 2 +- test/optional_test_ref_convert_assign_const_int_prevented.cpp | 2 +- test/optional_test_ref_convert_assign_mutable_int.cpp | 2 +- test/optional_test_ref_convert_assign_non_int.cpp | 2 +- test/optional_test_ref_converting_ctor.cpp | 2 +- test/optional_test_ref_move.cpp | 2 +- test/optional_test_ref_portable_minimum.cpp | 2 +- test/optional_test_ref_to_val.cpp | 2 +- test/optional_test_sfinae_friendly_ctor.cpp | 2 +- test/optional_test_static_properties.cpp | 2 +- test/optional_test_swap.cpp | 2 +- test/optional_test_tc_base.cpp | 2 +- test/optional_test_tie.cpp | 2 +- test/optional_test_value_access.cpp | 2 +- 42 files changed, 43 insertions(+), 43 deletions(-) diff --git a/include/boost/optional/detail/old_optional_implementation.hpp b/include/boost/optional/detail/old_optional_implementation.hpp index f8dc260d..3431e155 100644 --- a/include/boost/optional/detail/old_optional_implementation.hpp +++ b/include/boost/optional/detail/old_optional_implementation.hpp @@ -79,7 +79,7 @@ class optional_base : public optional_tag private : typedef -#if !BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564)) +#if !BOOST_WORKAROUND(BOOST_BORLANDC, BOOST_TESTED_AT(0x564)) BOOST_DEDUCED_TYPENAME #endif ::boost::detail::make_reference_content::type internal_type ; @@ -619,7 +619,7 @@ class optional_base : public optional_tag reference_const_type dereference( internal_type const* p, is_reference_tag ) const { return p->get() ; } reference_type dereference( internal_type* p, is_reference_tag ) { return p->get() ; } -#if BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x581)) +#if BOOST_WORKAROUND(BOOST_BORLANDC, BOOST_TESTED_AT(0x581)) void destroy_impl ( is_not_reference_tag ) { get_ptr_impl()->internal_type::~internal_type() ; m_initialized = false ; } #else void destroy_impl ( is_not_reference_tag ) { get_ptr_impl()->~T() ; m_initialized = false ; } diff --git a/include/boost/optional/detail/optional_config.hpp b/include/boost/optional/detail/optional_config.hpp index bb7e12f9..73f25054 100644 --- a/include/boost/optional/detail/optional_config.hpp +++ b/include/boost/optional/detail/optional_config.hpp @@ -28,7 +28,7 @@ # define BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT #endif -#if BOOST_WORKAROUND(__BORLANDC__, <= 0x551) +#if BOOST_WORKAROUND(BOOST_BORLANDC, <= 0x551) // BCB (5.5.1) cannot parse the nested template struct in an inplace factory. # define BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT #endif diff --git a/test/optional_ref_assign_test_defs.hpp b/test/optional_ref_assign_test_defs.hpp index 1b2a1b03..7185ff4a 100644 --- a/test/optional_ref_assign_test_defs.hpp +++ b/test/optional_ref_assign_test_defs.hpp @@ -13,7 +13,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test.cpp b/test/optional_test.cpp index 3354430b..a0fa5a6d 100644 --- a/test/optional_test.cpp +++ b/test/optional_test.cpp @@ -24,7 +24,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_conversions_from_U.cpp b/test/optional_test_conversions_from_U.cpp index 57d82157..309cb869 100644 --- a/test/optional_test_conversions_from_U.cpp +++ b/test/optional_test_conversions_from_U.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_convert_from_T.cpp b/test/optional_test_convert_from_T.cpp index 6d4c2ffd..bfa1a0aa 100644 --- a/test/optional_test_convert_from_T.cpp +++ b/test/optional_test_convert_from_T.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_emplace.cpp b/test/optional_test_emplace.cpp index 36972d38..d44e1d10 100644 --- a/test/optional_test_emplace.cpp +++ b/test/optional_test_emplace.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_empty_braces.cpp b/test/optional_test_empty_braces.cpp index 593a68f8..273d81d1 100644 --- a/test/optional_test_empty_braces.cpp +++ b/test/optional_test_empty_braces.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_equals_none.cpp b/test/optional_test_equals_none.cpp index 1c8c5d8c..1e3157b1 100644 --- a/test/optional_test_equals_none.cpp +++ b/test/optional_test_equals_none.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_experimental_traits.cpp b/test/optional_test_experimental_traits.cpp index 80930567..5088b4a2 100644 --- a/test/optional_test_experimental_traits.cpp +++ b/test/optional_test_experimental_traits.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_flat_map.cpp b/test/optional_test_flat_map.cpp index 409e1111..a6b2b131 100644 --- a/test/optional_test_flat_map.cpp +++ b/test/optional_test_flat_map.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_inplace_factory.cpp b/test/optional_test_inplace_factory.cpp index 1e852f0a..b1624f61 100644 --- a/test/optional_test_inplace_factory.cpp +++ b/test/optional_test_inplace_factory.cpp @@ -13,7 +13,7 @@ #include #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_inplace_fail.cpp b/test/optional_test_inplace_fail.cpp index bb7c26f6..38722baf 100644 --- a/test/optional_test_inplace_fail.cpp +++ b/test/optional_test_inplace_fail.cpp @@ -13,7 +13,7 @@ #include #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_inplace_fail2.cpp b/test/optional_test_inplace_fail2.cpp index e6a00044..ad4cedd3 100644 --- a/test/optional_test_inplace_fail2.cpp +++ b/test/optional_test_inplace_fail2.cpp @@ -13,7 +13,7 @@ #include #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_io.cpp b/test/optional_test_io.cpp index 9dab619b..14c2b26f 100644 --- a/test/optional_test_io.cpp +++ b/test/optional_test_io.cpp @@ -14,7 +14,7 @@ #include "boost/optional/optional.hpp" #include "boost/optional/optional_io.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_make_optional.cpp b/test/optional_test_make_optional.cpp index 8230c198..be271bdd 100644 --- a/test/optional_test_make_optional.cpp +++ b/test/optional_test_make_optional.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_map.cpp b/test/optional_test_map.cpp index 288249c0..3c1617ba 100644 --- a/test/optional_test_map.cpp +++ b/test/optional_test_map.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_maybe_uninitialized_warning.cpp b/test/optional_test_maybe_uninitialized_warning.cpp index a9a07079..7660ece6 100644 --- a/test/optional_test_maybe_uninitialized_warning.cpp +++ b/test/optional_test_maybe_uninitialized_warning.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_member_T.cpp b/test/optional_test_member_T.cpp index 325838db..c31fedb5 100644 --- a/test/optional_test_member_T.cpp +++ b/test/optional_test_member_T.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_minimum_requirements.cpp b/test/optional_test_minimum_requirements.cpp index 77ef1fc2..1e22735d 100644 --- a/test/optional_test_minimum_requirements.cpp +++ b/test/optional_test_minimum_requirements.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_move.cpp b/test/optional_test_move.cpp index 1558c342..f27cd998 100644 --- a/test/optional_test_move.cpp +++ b/test/optional_test_move.cpp @@ -12,7 +12,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_msvc_bug_workaround.cpp b/test/optional_test_msvc_bug_workaround.cpp index 30f3b02f..126e8850 100644 --- a/test/optional_test_msvc_bug_workaround.cpp +++ b/test/optional_test_msvc_bug_workaround.cpp @@ -12,7 +12,7 @@ #define BOOST_OPTIONAL_CONFIG_NO_RVALUE_REFERENCES #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_noexcept_move.cpp b/test/optional_test_noexcept_move.cpp index 0675844e..2e270ed5 100644 --- a/test/optional_test_noexcept_move.cpp +++ b/test/optional_test_noexcept_move.cpp @@ -12,7 +12,7 @@ #include "boost/static_assert.hpp" #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_old_impl.cpp b/test/optional_test_old_impl.cpp index 994d989d..f3da56e1 100644 --- a/test/optional_test_old_impl.cpp +++ b/test/optional_test_old_impl.cpp @@ -12,7 +12,7 @@ #define BOOST_OPTIONAL_CONFIG_USE_OLD_IMPLEMENTATION_OF_OPTIONAL // does old implementation still work for basic usage? #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_path_assignment.cpp b/test/optional_test_path_assignment.cpp index f0c214a5..50cda0a1 100644 --- a/test/optional_test_path_assignment.cpp +++ b/test/optional_test_path_assignment.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_ref_assign_const_int.cpp b/test/optional_test_ref_assign_const_int.cpp index a14ef6da..6dddf9ec 100644 --- a/test/optional_test_ref_assign_const_int.cpp +++ b/test/optional_test_ref_assign_const_int.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_ref_assign_mutable_int.cpp b/test/optional_test_ref_assign_mutable_int.cpp index 1c674dac..5aa717e7 100644 --- a/test/optional_test_ref_assign_mutable_int.cpp +++ b/test/optional_test_ref_assign_mutable_int.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_ref_assign_portable_minimum.cpp b/test/optional_test_ref_assign_portable_minimum.cpp index 19085d3f..31599f30 100644 --- a/test/optional_test_ref_assign_portable_minimum.cpp +++ b/test/optional_test_ref_assign_portable_minimum.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_ref_convert_assign_const_int.cpp b/test/optional_test_ref_convert_assign_const_int.cpp index fb44aa1f..0d6585ff 100644 --- a/test/optional_test_ref_convert_assign_const_int.cpp +++ b/test/optional_test_ref_convert_assign_const_int.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_ref_convert_assign_const_int_prevented.cpp b/test/optional_test_ref_convert_assign_const_int_prevented.cpp index 7690d801..e692475f 100644 --- a/test/optional_test_ref_convert_assign_const_int_prevented.cpp +++ b/test/optional_test_ref_convert_assign_const_int_prevented.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_ref_convert_assign_mutable_int.cpp b/test/optional_test_ref_convert_assign_mutable_int.cpp index 56a6e80d..6003c433 100644 --- a/test/optional_test_ref_convert_assign_mutable_int.cpp +++ b/test/optional_test_ref_convert_assign_mutable_int.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_ref_convert_assign_non_int.cpp b/test/optional_test_ref_convert_assign_non_int.cpp index 80566b2b..93d3c3f2 100644 --- a/test/optional_test_ref_convert_assign_non_int.cpp +++ b/test/optional_test_ref_convert_assign_non_int.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_ref_converting_ctor.cpp b/test/optional_test_ref_converting_ctor.cpp index 81f3c0f4..6f6517a8 100644 --- a/test/optional_test_ref_converting_ctor.cpp +++ b/test/optional_test_ref_converting_ctor.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_ref_move.cpp b/test/optional_test_ref_move.cpp index 78b7bf27..bf0bcb84 100644 --- a/test/optional_test_ref_move.cpp +++ b/test/optional_test_ref_move.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_ref_portable_minimum.cpp b/test/optional_test_ref_portable_minimum.cpp index c929c3a2..ec5b827a 100644 --- a/test/optional_test_ref_portable_minimum.cpp +++ b/test/optional_test_ref_portable_minimum.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_ref_to_val.cpp b/test/optional_test_ref_to_val.cpp index 19e1675d..e93469f1 100644 --- a/test/optional_test_ref_to_val.cpp +++ b/test/optional_test_ref_to_val.cpp @@ -12,7 +12,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_sfinae_friendly_ctor.cpp b/test/optional_test_sfinae_friendly_ctor.cpp index 87539e1c..c13bb2bb 100644 --- a/test/optional_test_sfinae_friendly_ctor.cpp +++ b/test/optional_test_sfinae_friendly_ctor.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_static_properties.cpp b/test/optional_test_static_properties.cpp index c47bfa99..5dc10537 100644 --- a/test/optional_test_static_properties.cpp +++ b/test/optional_test_static_properties.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_swap.cpp b/test/optional_test_swap.cpp index 2feed252..2294c703 100644 --- a/test/optional_test_swap.cpp +++ b/test/optional_test_swap.cpp @@ -17,7 +17,7 @@ #include "boost/optional/optional.hpp" #include "boost/utility/in_place_factory.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_tc_base.cpp b/test/optional_test_tc_base.cpp index a1d293ba..8c78dc0c 100644 --- a/test/optional_test_tc_base.cpp +++ b/test/optional_test_tc_base.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_tie.cpp b/test/optional_test_tie.cpp index b5c5818f..1ea34f44 100644 --- a/test/optional_test_tie.cpp +++ b/test/optional_test_tie.cpp @@ -12,7 +12,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif diff --git a/test/optional_test_value_access.cpp b/test/optional_test_value_access.cpp index 47ec5cca..c11cb423 100644 --- a/test/optional_test_value_access.cpp +++ b/test/optional_test_value_access.cpp @@ -11,7 +11,7 @@ #include "boost/optional/optional.hpp" -#ifdef __BORLANDC__ +#ifdef BOOST_BORLANDC #pragma hdrstop #endif From 19b94c01f39238dced0d8ed8f12a8179f3c2b0c6 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 9 Apr 2020 01:12:22 +0200 Subject: [PATCH 013/163] added release notes --- doc/91_relnotes.qbk | 2 ++ doc/html/boost_optional/relnotes.html | 8 ++++++++ doc/html/index.html | 2 +- 3 files changed, 11 insertions(+), 1 deletion(-) diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index b5be701d..e4a5eaa2 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -15,6 +15,8 @@ * Fixed [@https://github.com/boostorg/optional/issues/78 issue #78]. * `boost::none` is now declared as an inline variable (on compilers taht support it): there is only one instance of `boost::none` across all translation units. +* Fixed a number of compilation errors in GCC 4.4.7 in `optional` for trivial `T`s. Thanks to Robert Leahy for the fix. For details see [@https://github.com/boostorg/optional/pull/80 pr #78]. +* Now surpressing warning `-Wweak-vtables`. [heading Boost Release 1.69] diff --git a/doc/html/boost_optional/relnotes.html b/doc/html/boost_optional/relnotes.html index 333178d1..6e93d04e 100644 --- a/doc/html/boost_optional/relnotes.html +++ b/doc/html/boost_optional/relnotes.html @@ -40,6 +40,14 @@

boost::none is now declared as an inline variable (on compilers taht support it): there is only one instance of boost::none across all translation units. +
  • + Fixed a number of compilation errors in GCC 4.4.7 in optional<T> for trivial Ts. + Thanks to Robert Leahy for the fix. For details see pr + #78. +
    • +
  • + Now surpressing warning -Wweak-vtables. +

    • diff --git a/doc/html/index.html b/doc/html/index.html index 0a5611fd..2862ec6a 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -145,7 +145,7 @@

    - +

    Last revised: December 19, 2019 at 23:27:43 GMT

    Last revised: April 08, 2020 at 23:09:18 GMT
    From db5e156ebcd5483324f9ee2f0b6746e1698aa5f9 Mon Sep 17 00:00:00 2001 From: Moritz Baumann Date: Tue, 11 Aug 2020 10:36:12 +0200 Subject: [PATCH 014/163] Add explicit include to make tests compile with MSVC --- test/optional_test_emplace.cpp | 1 + test/optional_test_minimum_requirements.cpp | 1 + 2 files changed, 2 insertions(+) diff --git a/test/optional_test_emplace.cpp b/test/optional_test_emplace.cpp index d44e1d10..5182d97f 100644 --- a/test/optional_test_emplace.cpp +++ b/test/optional_test_emplace.cpp @@ -15,6 +15,7 @@ #pragma hdrstop #endif +#include #include "boost/core/lightweight_test.hpp" #include "boost/none.hpp" diff --git a/test/optional_test_minimum_requirements.cpp b/test/optional_test_minimum_requirements.cpp index 1e22735d..11ff247e 100644 --- a/test/optional_test_minimum_requirements.cpp +++ b/test/optional_test_minimum_requirements.cpp @@ -15,6 +15,7 @@ #pragma hdrstop #endif +#include #include "boost/core/lightweight_test.hpp" #include "boost/none.hpp" From 9de55e6ffd97872a89d44fa06014f838b1615e73 Mon Sep 17 00:00:00 2001 From: Giovanni Mascellani Date: Sun, 17 Nov 2019 17:05:37 +0100 Subject: [PATCH 015/163] Fix funny mistake in copyright headers. --- test/optional_test_deleted_default_ctor.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/test/optional_test_deleted_default_ctor.cpp b/test/optional_test_deleted_default_ctor.cpp index 790753c4..1fe2bdb6 100644 --- a/test/optional_test_deleted_default_ctor.cpp +++ b/test/optional_test_deleted_default_ctor.cpp @@ -1,5 +1,5 @@ // Copyright 2017 Peter Dimov -// Copyright 2017 Vinnie NotDefaultConstructible +// Copyright 2017 Vinnie Falco // Copyright 2018 Andrzej Krzemienski // // Distributed under the Boost Software License, Version 1.0. From 7e0b8145b51221bcae49f83d0ab53722c9056044 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Sat, 24 Oct 2020 17:17:10 +0200 Subject: [PATCH 016/163] boost::none is constexpr-declared --- doc/21_ref_none.qbk | 4 +- doc/91_relnotes.qbk | 12 ++++-- doc/html/boost_optional/acknowledgements.html | 4 +- .../dependencies_and_portability.html | 4 +- ...emplace_operations_in_older_compilers.html | 4 +- .../optional_reference_binding.html | 4 +- doc/html/boost_optional/quick_start.html | 4 +- ...sing_unnecessary_default_construction.html | 4 +- .../optional_automatic_variables.html | 4 +- .../quick_start/optional_data_members.html | 4 +- .../quick_start/storage_in_containers.html | 4 +- ...ost_optional_bad_optional_access_hpp_.html | 4 +- .../detailed_semantics.html | 4 +- .../header__boost_optional_hpp_.html | 4 +- ...der__boost_optional_optional_fwd_hpp_.html | 4 +- .../detailed_semantics___free_functions.html | 4 +- ...ailed_semantics___optional_references.html | 4 +- .../detailed_semantics___optional_values.html | 4 +- .../header_optional_in_place_init.html | 4 +- .../header_optional_optional_refs.html | 4 +- .../header_optional_optional_values.html | 4 +- .../boost_optional/reference/io_header.html | 4 +- .../reference/io_header/io_semantics.html | 14 +++---- doc/html/boost_optional/relnotes.html | 42 ++++++++++++------- .../tutorial/design_overview.html | 12 +++--- .../design_overview/the_interface.html | 8 ++-- .../design_overview/the_semantics.html | 4 +- .../tutorial/exception_safety_guarantees.html | 4 +- doc/html/boost_optional/tutorial/gotchas.html | 6 +-- ...e_positive_with__wmaybe_uninitialized.html | 4 +- .../gotchas/mixed_relational_comparisons.html | 4 +- .../gotchas/moved_from__optional_.html | 4 +- .../tutorial/in_place_factories.html | 4 +- .../boost_optional/tutorial/io_operators.html | 4 +- .../tutorial/optional_references.html | 4 +- ...for_assignment_of_optional_references.html | 4 +- .../tutorial/performance_considerations.html | 4 +- .../tutorial/relational_operators.html | 4 +- .../tutorial/type_requirements.html | 4 +- .../tutorial/when_to_use_optional.html | 4 +- doc/html/index.html | 8 ++-- doc/html/optional/reference.html | 6 +-- .../header__boost_optional_optional_hpp_.html | 4 +- doc/html/optional/tutorial.html | 4 +- include/boost/none.hpp | 7 ++-- 45 files changed, 139 insertions(+), 120 deletions(-) diff --git a/doc/21_ref_none.qbk b/doc/21_ref_none.qbk index 011eff7c..65eaa81f 100644 --- a/doc/21_ref_none.qbk +++ b/doc/21_ref_none.qbk @@ -17,8 +17,8 @@ namespace boost { class none_t {/* see below */}; -const none_t none (/* see below */); - +inline constexpr none_t none (/* see below */); + } // namespace boost ``` diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index e4a5eaa2..79f881fc 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -11,18 +11,24 @@ [section:relnotes Release Notes] +[heading Boost Release 1.75] + +* `boost::none` is `constexpr`-declared. + +* Fixed [@https://github.com/boostorg/optional/issues/78 issue #78]. + [heading Boost Release 1.73] * Fixed [@https://github.com/boostorg/optional/issues/78 issue #78]. -* `boost::none` is now declared as an inline variable (on compilers taht support it): there is only one instance of `boost::none` across all translation units. +* `boost::none` is now declared as an inline variable (on compilers taht support it): there is only one instance of `boost::none` across all translation units. * Fixed a number of compilation errors in GCC 4.4.7 in `optional` for trivial `T`s. Thanks to Robert Leahy for the fix. For details see [@https://github.com/boostorg/optional/pull/80 pr #78]. -* Now surpressing warning `-Wweak-vtables`. +* Now surpressing warning `-Wweak-vtables`. [heading Boost Release 1.69] * Remove deprecation mark from `reset()` method (without arguments). * Fixed [@https://github.com/boostorg/optional/issues/59 issue #59]. -* Fixed bug with initialization of certain wrapper types in clang with -std=c++03. See [@https://github.com/boostorg/optional/pull/64 pr #64]. +* Fixed bug with initialization of certain wrapper types in clang with -std=c++03. See [@https://github.com/boostorg/optional/pull/64 pr #64]. [heading Boost Release 1.68] diff --git a/doc/html/boost_optional/acknowledgements.html b/doc/html/boost_optional/acknowledgements.html index c6f9f2f7..eff2ed8d 100644 --- a/doc/html/boost_optional/acknowledgements.html +++ b/doc/html/boost_optional/acknowledgements.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -116,7 +116,7 @@

    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/dependencies_and_portability.html b/doc/html/boost_optional/dependencies_and_portability.html index bc235f84..b9075293 100644 --- a/doc/html/boost_optional/dependencies_and_portability.html +++ b/doc/html/boost_optional/dependencies_and_portability.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -77,7 +77,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html b/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html index a35c4a2c..fbf541f7 100644 --- a/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html +++ b/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -76,7 +76,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html b/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html index 7a191d27..b2e67419 100644 --- a/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html +++ b/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -93,7 +93,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/quick_start.html b/doc/html/boost_optional/quick_start.html index 0ef16bc8..308503d3 100644 --- a/doc/html/boost_optional/quick_start.html +++ b/doc/html/boost_optional/quick_start.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -155,7 +155,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html b/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html index e039e0ce..bfbc9d1c 100644 --- a/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html +++ b/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -61,7 +61,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/quick_start/optional_automatic_variables.html b/doc/html/boost_optional/quick_start/optional_automatic_variables.html index f7b66648..92ddb40b 100644 --- a/doc/html/boost_optional/quick_start/optional_automatic_variables.html +++ b/doc/html/boost_optional/quick_start/optional_automatic_variables.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -61,7 +61,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/quick_start/optional_data_members.html b/doc/html/boost_optional/quick_start/optional_data_members.html index a06aa105..f8b2d586 100644 --- a/doc/html/boost_optional/quick_start/optional_data_members.html +++ b/doc/html/boost_optional/quick_start/optional_data_members.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -80,7 +80,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/quick_start/storage_in_containers.html b/doc/html/boost_optional/quick_start/storage_in_containers.html index 4c145f11..0354e7b5 100644 --- a/doc/html/boost_optional/quick_start/storage_in_containers.html +++ b/doc/html/boost_optional/quick_start/storage_in_containers.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -50,7 +50,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html index 363379c1..2b834847 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html +++ b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -49,7 +49,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html index b1823243..4a2d4e6c 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html +++ b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -46,7 +46,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/reference/header__boost_optional_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_hpp_.html index c8d6b9e4..d0f45033 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_hpp_.html +++ b/doc/html/boost_optional/reference/header__boost_optional_hpp_.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -33,7 +33,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html index ee81dd92..be6176e3 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -52,7 +52,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html index b46bcce0..d0b7559d 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -507,7 +507,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html index e526f765..ee059b3f 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -538,7 +538,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html index ca180f49..44895b06 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -1774,7 +1774,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html index be67b67b..3ddefe87 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -47,7 +47,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html index 8cef0ab3..4f62db11 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -104,7 +104,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html index f6ed7da8..5ca126c7 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -139,7 +139,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/reference/io_header.html b/doc/html/boost_optional/reference/io_header.html index fd8599f6..ffb622ff 100644 --- a/doc/html/boost_optional/reference/io_header.html +++ b/doc/html/boost_optional/reference/io_header.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -58,7 +58,7 @@
    -
    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    +

    Copyright © 2003-2007 Fernando Luis Cacciola Carballal
    Copyright © 2014-2018 Andrzej Krzemieński

    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    diff --git a/doc/html/boost_optional/reference/io_header/io_semantics.html b/doc/html/boost_optional/reference/io_header/io_semantics.html index 2e8ed56c..b684717e 100644 --- a/doc/html/boost_optional/reference/io_header/io_semantics.html +++ b/doc/html/boost_optional/reference/io_header/io_semantics.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -32,7 +32,7 @@ <class CharType, class CharTrait, class T> -
        std::basic_ostream<CharType, CharTrait>&
        operator<<(std::basic_ostream<CharType, CharTrait>& +
        std::basic_ostream<CharType, CharTrait>&
        operator<<(std::basic_ostream<CharType, CharTrait>& out, optional<T> const& v);

    @@ -53,8 +53,8 @@

    template <class CharType, class CharTrait, - class T>
        std::basic_ostream<CharType, CharTrait>& -
        operator<<(std::basic_ostream<CharType, CharTrait>& out, none_t); + class T>
        std::basic_ostream<CharType, CharTrait>& +
        operator<<(std::basic_ostream<CharType, CharTrait>& out, none_t);

    • @@ -70,8 +70,8 @@

      template <class CharType, class CharTrait, - class T>
          std::basic_ostream<CharType, CharTrait>& -
          operator>>(std::basic_istream<CharType, CharTrait>& in, optional<T>& v); + class T>
          std::basic_ostream<CharType, CharTrait>& +
          operator>>(std::basic_istream<CharType, CharTrait>& in, optional<T>& v);

      • @@ -98,7 +98,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/relnotes.html b/doc/html/boost_optional/relnotes.html index 6e93d04e..383ab5d4 100644 --- a/doc/html/boost_optional/relnotes.html +++ b/doc/html/boost_optional/relnotes.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -28,6 +28,20 @@

      + Boost + Release 1.75 +

      +
        +
      • + boost::none is constexpr-declared. +
        • +
      • + Fixed issue + #78. +
        • +
      +

      + Boost Release 1.73

      @@ -50,7 +64,7 @@

      - + Boost Release 1.69

      @@ -68,7 +82,7 @@

      - + Boost Release 1.68

      @@ -85,7 +99,7 @@

      - + Boost Release 1.67

      @@ -99,7 +113,7 @@

      - + Boost Release 1.66

      @@ -117,7 +131,7 @@

      - + Boost Release 1.63

      @@ -141,7 +155,7 @@

      - + Boost Release 1.62

      @@ -149,7 +163,7 @@

      Fixed Trac #12179.

      - + Boost Release 1.61

      @@ -192,7 +206,7 @@

      - + Boost Release 1.60

      @@ -203,7 +217,7 @@

      #11203.

      - + Boost Release 1.59

      @@ -217,7 +231,7 @@

      - + Boost Release 1.58

      @@ -253,7 +267,7 @@

      - + Boost Release 1.57

      @@ -263,7 +277,7 @@

      to fix C++03 compile error on logic_error("...")".

      - + Boost Release 1.56

      @@ -320,7 +334,7 @@

      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/design_overview.html b/doc/html/boost_optional/tutorial/design_overview.html index 31a192b5..379ac603 100644 --- a/doc/html/boost_optional/tutorial/design_overview.html +++ b/doc/html/boost_optional/tutorial/design_overview.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -65,8 +65,8 @@ npos, -1, etc... This is equivalent to adding the special value to the set of possible values of a given type. This super set of T - plus some nil_t—where nil_t - is some stateless POD—can be modeled in modern languages as a discriminated union of T and nil_t. Discriminated + plus some nil_t—where nil_t + is some stateless POD—can be modeled in modern languages as a discriminated union of T and nil_t. Discriminated unions are often called variants. A variant has a current type, which in our case is either T or nil_t. Using the Boost.Variant @@ -100,8 +100,8 @@

      In any event, both the discriminated-union or the single-element container - models serve as a conceptual ground for a class representing optional—i.e. - possibly uninitialized—objects. For instance, these models show the + models serve as a conceptual ground for a class representing optional—i.e. + possibly uninitialized—objects. For instance, these models show the exact semantics required for a wrapper of optional values:

      @@ -170,7 +170,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/design_overview/the_interface.html b/doc/html/boost_optional/tutorial/design_overview/the_interface.html index 0bb4a963..4ac1fb95 100644 --- a/doc/html/boost_optional/tutorial/design_overview/the_interface.html +++ b/doc/html/boost_optional/tutorial/design_overview/the_interface.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -79,7 +79,7 @@
      facto standard for handling optional objects because all you have to do to refer to a value which you don't really have is to use a null pointer value of the appropriate type. Pointers have been used for - decades—from the days of C APIs to modern C++ libraries—to refer + decades—from the days of C APIs to modern C++ libraries—to refer to optional (that is, possibly nonexistent) objects; particularly as optional arguments to a function, but also quite often as optional data members.

      @@ -93,7 +93,7 @@
      and this information is tied to the syntax of the expressions. That is, the presence of operators * and -> tell by themselves - —without any additional context— that the expression will be undefined + —without any additional context— that the expression will be undefined unless the implied pointee actually exist.

      @@ -173,7 +173,7 @@

      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/design_overview/the_semantics.html b/doc/html/boost_optional/tutorial/design_overview/the_semantics.html index dbc1ab02..49ecdc5a 100644 --- a/doc/html/boost_optional/tutorial/design_overview/the_semantics.html +++ b/doc/html/boost_optional/tutorial/design_overview/the_semantics.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -107,7 +107,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/exception_safety_guarantees.html b/doc/html/boost_optional/tutorial/exception_safety_guarantees.html index c75dab07..177682b1 100644 --- a/doc/html/boost_optional/tutorial/exception_safety_guarantees.html +++ b/doc/html/boost_optional/tutorial/exception_safety_guarantees.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -161,7 +161,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas.html b/doc/html/boost_optional/tutorial/gotchas.html index c11cad2f..ebc2fe54 100644 --- a/doc/html/boost_optional/tutorial/gotchas.html +++ b/doc/html/boost_optional/tutorial/gotchas.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -37,7 +37,7 @@

      First, it is functionally similar to a tristate boolean (false, maybe, - true) —such as boost::tribool— + true) —such as boost::tribool— except that in a tristate boolean, the maybe state represents a valid value, unlike the corresponding state of an uninitialized optional<bool>. @@ -98,7 +98,7 @@

      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html b/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html index 240ee0fc..a6237273 100644 --- a/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html +++ b/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -63,7 +63,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html b/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html index 8d25f0d3..35e7d8c0 100644 --- a/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html +++ b/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -45,7 +45,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html b/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html index 7a4e4448..8de3f004 100644 --- a/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html +++ b/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -49,7 +49,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/in_place_factories.html b/doc/html/boost_optional/tutorial/in_place_factories.html index 5f0c4261..1a34626d 100644 --- a/doc/html/boost_optional/tutorial/in_place_factories.html +++ b/doc/html/boost_optional/tutorial/in_place_factories.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -183,7 +183,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/io_operators.html b/doc/html/boost_optional/tutorial/io_operators.html index 713b2838..ea95994d 100644 --- a/doc/html/boost_optional/tutorial/io_operators.html +++ b/doc/html/boost_optional/tutorial/io_operators.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -73,7 +73,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/optional_references.html b/doc/html/boost_optional/tutorial/optional_references.html index fb0fb564..ff8a79a2 100644 --- a/doc/html/boost_optional/tutorial/optional_references.html +++ b/doc/html/boost_optional/tutorial/optional_references.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -103,7 +103,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html b/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html index 6e827d09..49b75164 100644 --- a/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html +++ b/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -133,7 +133,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/performance_considerations.html b/doc/html/boost_optional/tutorial/performance_considerations.html index 19fe1ed8..fffaa76c 100644 --- a/doc/html/boost_optional/tutorial/performance_considerations.html +++ b/doc/html/boost_optional/tutorial/performance_considerations.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -251,7 +251,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/relational_operators.html b/doc/html/boost_optional/tutorial/relational_operators.html index 376bdccd..63311725 100644 --- a/doc/html/boost_optional/tutorial/relational_operators.html +++ b/doc/html/boost_optional/tutorial/relational_operators.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -99,7 +99,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/type_requirements.html b/doc/html/boost_optional/tutorial/type_requirements.html index d213a4f5..9d2dbdef 100644 --- a/doc/html/boost_optional/tutorial/type_requirements.html +++ b/doc/html/boost_optional/tutorial/type_requirements.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -95,7 +95,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/when_to_use_optional.html b/doc/html/boost_optional/tutorial/when_to_use_optional.html index 3caec24d..599b8c56 100644 --- a/doc/html/boost_optional/tutorial/when_to_use_optional.html +++ b/doc/html/boost_optional/tutorial/when_to_use_optional.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -128,7 +128,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/index.html b/doc/html/index.html index 2862ec6a..581c86db 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -25,8 +25,8 @@

      Fernando Luis Cacciola Carballal

      -

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal

      -

      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal

      +

      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying @@ -145,7 +145,7 @@

      - +

      Last revised: April 08, 2020 at 23:09:18 GMT

      Last revised: October 24, 2020 at 15:15:55 GMT
      diff --git a/doc/html/optional/reference.html b/doc/html/optional/reference.html index d3b0ab72..b57e943b 100644 --- a/doc/html/optional/reference.html +++ b/doc/html/optional/reference.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -54,7 +54,7 @@ class none_t {/* see below */}; -const none_t none (/* see below */); +inline constexpr none_t none (/* see below */); } // namespace boost @@ -75,7 +75,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/optional/reference/header__boost_optional_optional_hpp_.html b/doc/html/optional/reference/header__boost_optional_optional_hpp_.html index c416301b..469a3d69 100644 --- a/doc/html/optional/reference/header__boost_optional_optional_hpp_.html +++ b/doc/html/optional/reference/header__boost_optional_optional_hpp_.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -97,7 +97,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/optional/tutorial.html b/doc/html/optional/tutorial.html index 972f9f70..8487a87a 100644 --- a/doc/html/optional/tutorial.html +++ b/doc/html/optional/tutorial.html @@ -1,6 +1,6 @@ - + Codestin Search App @@ -139,7 +139,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/include/boost/none.hpp b/include/boost/none.hpp index b5df2143..5f927cc3 100644 --- a/include/boost/none.hpp +++ b/include/boost/none.hpp @@ -24,7 +24,7 @@ namespace boost { #ifdef BOOST_OPTIONAL_USE_OLD_DEFINITION_OF_NONE -BOOST_INLINE_VARIABLE none_t const none = (static_cast(0)) ; +BOOST_INLINE_VARIABLE none_t BOOST_CONSTEXPR_OR_CONST none = (static_cast(0)) ; #elif defined BOOST_OPTIONAL_USE_SINGLETON_DEFINITION_OF_NONE @@ -45,16 +45,15 @@ namespace detail { namespace optional_detail { namespace { // TU-local - const none_t& none = detail::optional_detail::none_instance::instance; + const none_t& none = detail::optional_detail::none_instance::instance; } #else -BOOST_INLINE_VARIABLE const none_t none ((none_t::init_tag())); +BOOST_INLINE_VARIABLE BOOST_CONSTEXPR_OR_CONST none_t none ((none_t::init_tag())); #endif // older definitions } // namespace boost #endif // header guard - From 45321f321e9d57236fe4e35a1f4f854e8a69f068 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Wed, 28 Oct 2020 22:29:13 +0100 Subject: [PATCH 017/163] polished release notes --- doc/91_relnotes.qbk | 2 +- doc/html/boost_optional/relnotes.html | 2 +- doc/html/index.html | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index 79f881fc..40a08568 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -20,7 +20,7 @@ [heading Boost Release 1.73] * Fixed [@https://github.com/boostorg/optional/issues/78 issue #78]. -* `boost::none` is now declared as an inline variable (on compilers taht support it): there is only one instance of `boost::none` across all translation units. +* `boost::none` is now declared as an inline variable (on compilers that support it): there is only one instance of `boost::none` across all translation units. * Fixed a number of compilation errors in GCC 4.4.7 in `optional` for trivial `T`s. Thanks to Robert Leahy for the fix. For details see [@https://github.com/boostorg/optional/pull/80 pr #78]. * Now surpressing warning `-Wweak-vtables`. diff --git a/doc/html/boost_optional/relnotes.html b/doc/html/boost_optional/relnotes.html index 383ab5d4..aaecb720 100644 --- a/doc/html/boost_optional/relnotes.html +++ b/doc/html/boost_optional/relnotes.html @@ -52,7 +52,7 @@

    • boost::none is now declared as an inline variable - (on compilers taht support it): there is only one instance of boost::none across all translation units. + (on compilers that support it): there is only one instance of boost::none across all translation units.
    • Fixed a number of compilation errors in GCC 4.4.7 in optional<T> for trivial Ts. diff --git a/doc/html/index.html b/doc/html/index.html index 581c86db..4fee8ec9 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -145,7 +145,7 @@

      • - +

      Last revised: October 24, 2020 at 15:15:55 GMT

      Last revised: October 28, 2020 at 21:28:19 GMT
      From ead529af54a5776f01b7cedb2e551db844dda9e4 Mon Sep 17 00:00:00 2001 From: gieseanw Date: Fri, 18 Dec 2020 11:13:47 -0600 Subject: [PATCH 018/163] Address unreachable code warning In MSVC optional::value() emits a warning C4702: unreachable code because throw_exception is marked BOOST_RETURN. Otherwise the ternary code might have been preferable. This change addresses the warning while preserving the functionality. It replicates optional::value() for consistency. --- doc/00_optional.qbk | 8 ++--- doc/91_relnotes.qbk | 4 +++ doc/html/boost_optional/acknowledgements.html | 2 +- .../dependencies_and_portability.html | 2 +- ...emplace_operations_in_older_compilers.html | 2 +- .../optional_reference_binding.html | 2 +- doc/html/boost_optional/quick_start.html | 2 +- ...sing_unnecessary_default_construction.html | 2 +- .../optional_automatic_variables.html | 2 +- .../quick_start/optional_data_members.html | 2 +- .../quick_start/storage_in_containers.html | 2 +- ...ost_optional_bad_optional_access_hpp_.html | 2 +- .../detailed_semantics.html | 2 +- .../header__boost_optional_hpp_.html | 2 +- ...der__boost_optional_optional_fwd_hpp_.html | 2 +- .../detailed_semantics___free_functions.html | 2 +- ...ailed_semantics___optional_references.html | 2 +- .../detailed_semantics___optional_values.html | 2 +- .../header_optional_in_place_init.html | 2 +- .../header_optional_optional_refs.html | 2 +- .../header_optional_optional_values.html | 2 +- .../boost_optional/reference/io_header.html | 2 +- .../reference/io_header/io_semantics.html | 2 +- doc/html/boost_optional/relnotes.html | 36 +++++++++++-------- .../tutorial/design_overview.html | 2 +- .../design_overview/the_interface.html | 2 +- .../design_overview/the_semantics.html | 2 +- .../tutorial/exception_safety_guarantees.html | 2 +- doc/html/boost_optional/tutorial/gotchas.html | 2 +- ...e_positive_with__wmaybe_uninitialized.html | 2 +- .../gotchas/mixed_relational_comparisons.html | 2 +- .../gotchas/moved_from__optional_.html | 2 +- .../tutorial/in_place_factories.html | 2 +- .../boost_optional/tutorial/io_operators.html | 2 +- .../tutorial/optional_references.html | 2 +- ...for_assignment_of_optional_references.html | 2 +- .../tutorial/performance_considerations.html | 2 +- .../tutorial/relational_operators.html | 2 +- .../tutorial/type_requirements.html | 2 +- .../tutorial/when_to_use_optional.html | 2 +- doc/html/index.html | 4 +-- doc/html/optional/reference.html | 2 +- .../header__boost_optional_optional_hpp_.html | 2 +- doc/html/optional/tutorial.html | 2 +- .../detail/optional_reference_spec.hpp | 9 ++++- 45 files changed, 79 insertions(+), 62 deletions(-) diff --git a/doc/00_optional.qbk b/doc/00_optional.qbk index 00b60965..fd7d014b 100644 --- a/doc/00_optional.qbk +++ b/doc/00_optional.qbk @@ -2,7 +2,7 @@ [quickbook 1.4] [authors [Cacciola Carballal, Fernando Luis]] [copyright 2003-2007 Fernando Luis Cacciola Carballal] - [copyright 2014-2018 Andrzej Krzemieński] + [copyright 2014-2020 Andrzej Krzemieński] [category miscellaneous] [id optional] [dirname optional] @@ -61,7 +61,7 @@ Suppose we want to read a parameter form a config file which represents some int This is how you solve it with `boost::optional`: #include - + boost::optional getConfigParam(std::string name); // return either an int or a `not-an-int` int main() @@ -71,7 +71,7 @@ This is how you solve it with `boost::optional`: else runWithNoMax(); } - + [endsect] [include 01_quick_start.qbk] @@ -102,5 +102,3 @@ This is how you solve it with `boost::optional`: [include 90_dependencies.qbk] [include 91_relnotes.qbk] [include 92_acknowledgments.qbk] - - diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index 79f881fc..82dad14b 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -11,6 +11,10 @@ [section:relnotes Release Notes] +[heading Boost Release 1.76] + +* Fixed MSVC warning C4702. + [heading Boost Release 1.75] * `boost::none` is `constexpr`-declared. diff --git a/doc/html/boost_optional/acknowledgements.html b/doc/html/boost_optional/acknowledgements.html index eff2ed8d..56c6f5c2 100644 --- a/doc/html/boost_optional/acknowledgements.html +++ b/doc/html/boost_optional/acknowledgements.html @@ -116,7 +116,7 @@

      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/dependencies_and_portability.html b/doc/html/boost_optional/dependencies_and_portability.html index b9075293..c7a3d63d 100644 --- a/doc/html/boost_optional/dependencies_and_portability.html +++ b/doc/html/boost_optional/dependencies_and_portability.html @@ -77,7 +77,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html b/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html index fbf541f7..55ba5d89 100644 --- a/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html +++ b/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html @@ -76,7 +76,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html b/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html index b2e67419..3a631f98 100644 --- a/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html +++ b/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html @@ -93,7 +93,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/quick_start.html b/doc/html/boost_optional/quick_start.html index 308503d3..3aa15bae 100644 --- a/doc/html/boost_optional/quick_start.html +++ b/doc/html/boost_optional/quick_start.html @@ -155,7 +155,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html b/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html index bfbc9d1c..db986ce9 100644 --- a/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html +++ b/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html @@ -61,7 +61,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/quick_start/optional_automatic_variables.html b/doc/html/boost_optional/quick_start/optional_automatic_variables.html index 92ddb40b..d6fcacbb 100644 --- a/doc/html/boost_optional/quick_start/optional_automatic_variables.html +++ b/doc/html/boost_optional/quick_start/optional_automatic_variables.html @@ -61,7 +61,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/quick_start/optional_data_members.html b/doc/html/boost_optional/quick_start/optional_data_members.html index f8b2d586..646746a6 100644 --- a/doc/html/boost_optional/quick_start/optional_data_members.html +++ b/doc/html/boost_optional/quick_start/optional_data_members.html @@ -80,7 +80,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/quick_start/storage_in_containers.html b/doc/html/boost_optional/quick_start/storage_in_containers.html index 0354e7b5..77f70143 100644 --- a/doc/html/boost_optional/quick_start/storage_in_containers.html +++ b/doc/html/boost_optional/quick_start/storage_in_containers.html @@ -50,7 +50,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html index 2b834847..e2a7d6d1 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html +++ b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html @@ -49,7 +49,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html index 4a2d4e6c..451b14e2 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html +++ b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html @@ -46,7 +46,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_hpp_.html index d0f45033..52af3272 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_hpp_.html +++ b/doc/html/boost_optional/reference/header__boost_optional_hpp_.html @@ -33,7 +33,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html index be6176e3..e7ed5e1e 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html @@ -52,7 +52,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html index d0b7559d..b7ff68f7 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html @@ -507,7 +507,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html index ee059b3f..12a865e5 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html @@ -538,7 +538,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html index 44895b06..712e3871 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html @@ -1774,7 +1774,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html index 3ddefe87..01a05e7e 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html @@ -47,7 +47,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html index 4f62db11..7da08d96 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html @@ -104,7 +104,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html index 5ca126c7..2d188679 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html @@ -139,7 +139,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/io_header.html b/doc/html/boost_optional/reference/io_header.html index ffb622ff..6c9dcdca 100644 --- a/doc/html/boost_optional/reference/io_header.html +++ b/doc/html/boost_optional/reference/io_header.html @@ -58,7 +58,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/io_header/io_semantics.html b/doc/html/boost_optional/reference/io_header/io_semantics.html index b684717e..15b199f6 100644 --- a/doc/html/boost_optional/reference/io_header/io_semantics.html +++ b/doc/html/boost_optional/reference/io_header/io_semantics.html @@ -98,7 +98,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/relnotes.html b/doc/html/boost_optional/relnotes.html index 383ab5d4..f973c6df 100644 --- a/doc/html/boost_optional/relnotes.html +++ b/doc/html/boost_optional/relnotes.html @@ -28,6 +28,14 @@

      + Boost + Release 1.76 +

      +
      • + Fixed MSVC warning C4702. +
      +

      + Boost Release 1.75

      @@ -41,7 +49,7 @@

      - + Boost Release 1.73

      @@ -64,7 +72,7 @@

      - + Boost Release 1.69

      @@ -82,7 +90,7 @@

      - + Boost Release 1.68

      @@ -99,7 +107,7 @@

      - + Boost Release 1.67

      @@ -113,7 +121,7 @@

      - + Boost Release 1.66

      @@ -131,7 +139,7 @@

      - + Boost Release 1.63

      @@ -155,7 +163,7 @@

      - + Boost Release 1.62

      @@ -163,7 +171,7 @@

      Fixed Trac #12179.

      - + Boost Release 1.61

      @@ -206,7 +214,7 @@

      - + Boost Release 1.60

      @@ -217,7 +225,7 @@

      #11203.

      - + Boost Release 1.59

      @@ -231,7 +239,7 @@

      - + Boost Release 1.58

      @@ -267,7 +275,7 @@

      - + Boost Release 1.57

      @@ -277,7 +285,7 @@

      to fix C++03 compile error on logic_error("...")".

      - + Boost Release 1.56

      @@ -334,7 +342,7 @@

      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/design_overview.html b/doc/html/boost_optional/tutorial/design_overview.html index 379ac603..d088659f 100644 --- a/doc/html/boost_optional/tutorial/design_overview.html +++ b/doc/html/boost_optional/tutorial/design_overview.html @@ -170,7 +170,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/design_overview/the_interface.html b/doc/html/boost_optional/tutorial/design_overview/the_interface.html index 4ac1fb95..2b25c711 100644 --- a/doc/html/boost_optional/tutorial/design_overview/the_interface.html +++ b/doc/html/boost_optional/tutorial/design_overview/the_interface.html @@ -173,7 +173,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/design_overview/the_semantics.html b/doc/html/boost_optional/tutorial/design_overview/the_semantics.html index 49ecdc5a..16436a50 100644 --- a/doc/html/boost_optional/tutorial/design_overview/the_semantics.html +++ b/doc/html/boost_optional/tutorial/design_overview/the_semantics.html @@ -107,7 +107,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/exception_safety_guarantees.html b/doc/html/boost_optional/tutorial/exception_safety_guarantees.html index 177682b1..4d6ffd21 100644 --- a/doc/html/boost_optional/tutorial/exception_safety_guarantees.html +++ b/doc/html/boost_optional/tutorial/exception_safety_guarantees.html @@ -161,7 +161,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas.html b/doc/html/boost_optional/tutorial/gotchas.html index ebc2fe54..a01b3d1d 100644 --- a/doc/html/boost_optional/tutorial/gotchas.html +++ b/doc/html/boost_optional/tutorial/gotchas.html @@ -98,7 +98,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html b/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html index a6237273..4055b916 100644 --- a/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html +++ b/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html @@ -63,7 +63,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html b/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html index 35e7d8c0..082c6c6b 100644 --- a/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html +++ b/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html @@ -45,7 +45,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html b/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html index 8de3f004..95499944 100644 --- a/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html +++ b/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html @@ -49,7 +49,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/in_place_factories.html b/doc/html/boost_optional/tutorial/in_place_factories.html index 1a34626d..37c76cdc 100644 --- a/doc/html/boost_optional/tutorial/in_place_factories.html +++ b/doc/html/boost_optional/tutorial/in_place_factories.html @@ -183,7 +183,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/io_operators.html b/doc/html/boost_optional/tutorial/io_operators.html index ea95994d..2afb07d7 100644 --- a/doc/html/boost_optional/tutorial/io_operators.html +++ b/doc/html/boost_optional/tutorial/io_operators.html @@ -73,7 +73,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/optional_references.html b/doc/html/boost_optional/tutorial/optional_references.html index ff8a79a2..8c9e2168 100644 --- a/doc/html/boost_optional/tutorial/optional_references.html +++ b/doc/html/boost_optional/tutorial/optional_references.html @@ -103,7 +103,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html b/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html index 49b75164..4581faee 100644 --- a/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html +++ b/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html @@ -133,7 +133,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/performance_considerations.html b/doc/html/boost_optional/tutorial/performance_considerations.html index fffaa76c..f486628b 100644 --- a/doc/html/boost_optional/tutorial/performance_considerations.html +++ b/doc/html/boost_optional/tutorial/performance_considerations.html @@ -251,7 +251,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/relational_operators.html b/doc/html/boost_optional/tutorial/relational_operators.html index 63311725..f618bc74 100644 --- a/doc/html/boost_optional/tutorial/relational_operators.html +++ b/doc/html/boost_optional/tutorial/relational_operators.html @@ -99,7 +99,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/type_requirements.html b/doc/html/boost_optional/tutorial/type_requirements.html index 9d2dbdef..172e1894 100644 --- a/doc/html/boost_optional/tutorial/type_requirements.html +++ b/doc/html/boost_optional/tutorial/type_requirements.html @@ -95,7 +95,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/when_to_use_optional.html b/doc/html/boost_optional/tutorial/when_to_use_optional.html index 599b8c56..66e18051 100644 --- a/doc/html/boost_optional/tutorial/when_to_use_optional.html +++ b/doc/html/boost_optional/tutorial/when_to_use_optional.html @@ -128,7 +128,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/index.html b/doc/html/index.html index 581c86db..f97beec0 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -26,7 +26,7 @@ Fernando Luis Cacciola Carballal

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal

      -

      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying @@ -145,7 +145,7 @@

      - +

      Last revised: October 24, 2020 at 15:15:55 GMT

      Last revised: December 18, 2020 at 22:54:39 GMT
      diff --git a/doc/html/optional/reference.html b/doc/html/optional/reference.html index b57e943b..8ab0bfeb 100644 --- a/doc/html/optional/reference.html +++ b/doc/html/optional/reference.html @@ -75,7 +75,7 @@ -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/optional/reference/header__boost_optional_optional_hpp_.html b/doc/html/optional/reference/header__boost_optional_optional_hpp_.html index 469a3d69..7d3e3456 100644 --- a/doc/html/optional/reference/header__boost_optional_optional_hpp_.html +++ b/doc/html/optional/reference/header__boost_optional_optional_hpp_.html @@ -97,7 +97,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/optional/tutorial.html b/doc/html/optional/tutorial.html index 8487a87a..57e3c089 100644 --- a/doc/html/optional/tutorial.html +++ b/doc/html/optional/tutorial.html @@ -139,7 +139,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2018 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/include/boost/optional/detail/optional_reference_spec.hpp b/include/boost/optional/detail/optional_reference_spec.hpp index 4be140c2..0dfeeefa 100644 --- a/include/boost/optional/detail/optional_reference_spec.hpp +++ b/include/boost/optional/detail/optional_reference_spec.hpp @@ -151,7 +151,14 @@ class optional : public optional_detail::optional_tag T* get_ptr() const BOOST_NOEXCEPT { return ptr_; } T* operator->() const { BOOST_ASSERT(ptr_); return ptr_; } T& operator*() const { BOOST_ASSERT(ptr_); return *ptr_; } - T& value() const { return ptr_ ? *ptr_ : (throw_exception(bad_optional_access()), *ptr_); } + + T& value() const + { + if (this->is_initialized()) + return this->get(); + else + throw_exception(bad_optional_access()); + } bool operator!() const BOOST_NOEXCEPT { return ptr_ == 0; } BOOST_EXPLICIT_OPERATOR_BOOL_NOEXCEPT() From 4a1a9c9cdd67d932454e32a569f5a5badf1a9447 Mon Sep 17 00:00:00 2001 From: Edward Diener Date: Wed, 20 Jan 2021 23:02:52 -0500 Subject: [PATCH 019/163] [skip ci] Add "cxxstd" json field. The "cxxstd" json field is being added to each Boost library's meta json information for libraries in order to specify the minumum C++ standard compilation level. The value of this field matches one of the values for 'cxxstd' in Boost.Build. The purpose of doing this is to provide information for the Boost website documentation for each library which will specify the minimum C++ standard compilation that an end-user must employ in order to use the particular library. This will aid end-users who want to know if they can successfully use a Boost library based on their C++ compiler's compilation level, without having to search the library's documentation to find this out. --- meta/libraries.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/meta/libraries.json b/meta/libraries.json index 2c602716..a263d7e8 100644 --- a/meta/libraries.json +++ b/meta/libraries.json @@ -12,5 +12,6 @@ "maintainers": [ "Fernando Cacciola ", "Andrzej Krzemienski " - ] + ], + "cxxstd": "03" } From 27971d8b11167c6db23fafb9029c78bf3e286eb7 Mon Sep 17 00:00:00 2001 From: sdarwin Date: Thu, 31 Dec 2020 15:49:02 +0000 Subject: [PATCH 020/163] add drone config [ci skip] --- .drone.star | 36 ++++++++++++++++++++++++++++++++++++ .drone/drone.sh | 37 +++++++++++++++++++++++++++++++++++++ 2 files changed, 73 insertions(+) create mode 100644 .drone.star create mode 100755 .drone/drone.sh diff --git a/.drone.star b/.drone.star new file mode 100644 index 00000000..0db25622 --- /dev/null +++ b/.drone.star @@ -0,0 +1,36 @@ +# Use, modification, and distribution are +# subject to the Boost Software License, Version 1.0. (See accompanying +# file LICENSE.txt) +# +# Copyright Rene Rivera 2020. + +# For Drone CI we use the Starlark scripting language to reduce duplication. +# As the yaml syntax for Drone CI is rather limited. +# +# +globalenv={} +linuxglobalimage="cppalliance/droneubuntu1604:1" +windowsglobalimage="cppalliance/dronevs2019" + +def main(ctx): + return [ + linux_cxx("TOOLSET=gcc COMPILER=g++ CXXSTD=03,11 Job 0", "g++", packages="", buildtype="boost", buildscript="drone", image=linuxglobalimage, environment={'TOOLSET': 'gcc', 'COMPILER': 'g++', 'CXXSTD': '03,11', 'DRONE_JOB_UUID': 'b6589fc6ab'}, globalenv=globalenv), + linux_cxx("TOOLSET=gcc COMPILER=g++-4.7 CXXSTD=03,11 Job 1", "g++-4.7", packages="g++-4.7", buildtype="boost", buildscript="drone", image=linuxglobalimage, environment={'TOOLSET': 'gcc', 'COMPILER': 'g++-4.7', 'CXXSTD': '03,11', 'DRONE_JOB_UUID': '356a192b79'}, globalenv=globalenv), + linux_cxx("TOOLSET=gcc COMPILER=g++-4.8 CXXSTD=03,11 Job 2", "g++-4.8", packages="g++-4.8", buildtype="boost", buildscript="drone", image=linuxglobalimage, environment={'TOOLSET': 'gcc', 'COMPILER': 'g++-4.8', 'CXXSTD': '03,11', 'DRONE_JOB_UUID': 'da4b9237ba'}, globalenv=globalenv), + linux_cxx("TOOLSET=gcc COMPILER=g++-4.9 CXXSTD=03,11 Job 3", "g++-4.9", packages="g++-4.9", buildtype="boost", buildscript="drone", image=linuxglobalimage, environment={'TOOLSET': 'gcc', 'COMPILER': 'g++-4.9', 'CXXSTD': '03,11', 'DRONE_JOB_UUID': '77de68daec'}, globalenv=globalenv), + linux_cxx("TOOLSET=gcc COMPILER=g++-5 CXXSTD=03,11,14,1z Job 4", "g++-5", packages="g++-5", buildtype="boost", buildscript="drone", image=linuxglobalimage, environment={'TOOLSET': 'gcc', 'COMPILER': 'g++-5', 'CXXSTD': '03,11,14,1z', 'DRONE_JOB_UUID': '1b64538924'}, globalenv=globalenv), + linux_cxx("TOOLSET=gcc COMPILER=g++-6 CXXSTD=03,11,14,1z Job 5", "g++-6", packages="g++-6", buildtype="boost", buildscript="drone", image=linuxglobalimage, environment={'TOOLSET': 'gcc', 'COMPILER': 'g++-6', 'CXXSTD': '03,11,14,1z', 'DRONE_JOB_UUID': 'ac3478d69a'}, globalenv=globalenv), + linux_cxx("TOOLSET=gcc COMPILER=g++-7 CXXSTD=03,11,14,17 Job 6", "g++-7", packages="g++-7", buildtype="boost", buildscript="drone", image="cppalliance/droneubuntu1404:1", environment={'TOOLSET': 'gcc', 'COMPILER': 'g++-7', 'CXXSTD': '03,11,14,17', 'DRONE_JOB_UUID': 'c1dfd96eea'}, globalenv=globalenv), + linux_cxx("TOOLSET=clang COMPILER=clang++ CXXSTD=03,11 Job 7", "clang++", packages="", buildtype="boost", buildscript="drone", image=linuxglobalimage, environment={'TOOLSET': 'clang', 'COMPILER': 'clang++', 'CXXSTD': '03,11', 'DRONE_JOB_UUID': '902ba3cda1'}, globalenv=globalenv), + linux_cxx("TOOLSET=clang COMPILER=clang++-3.5 CXXSTD=03, Job 8", "clang++-3.5", packages="clang-3.5 libstdc++-4.9-dev", llvm_os="precise", llvm_ver="3.5", buildtype="boost", buildscript="drone", image=linuxglobalimage, environment={'TOOLSET': 'clang', 'COMPILER': 'clang++-3.5', 'CXXSTD': '03,11,14,1z', 'DRONE_JOB_UUID': 'fe5dbbcea5'}, globalenv=globalenv), + linux_cxx("TOOLSET=clang COMPILER=clang++-3.6 CXXSTD=03, Job 9", "clang++-3.6", packages="clang-3.6", llvm_os="precise", llvm_ver="3.6", buildtype="boost", buildscript="drone", image=linuxglobalimage, environment={'TOOLSET': 'clang', 'COMPILER': 'clang++-3.6', 'CXXSTD': '03,11,14,1z', 'DRONE_JOB_UUID': '0ade7c2cf9'}, globalenv=globalenv), + linux_cxx("TOOLSET=clang COMPILER=clang++-3.7 CXXSTD=03, Job 10", "clang++-3.7", packages="clang-3.7", llvm_os="precise", llvm_ver="3.7", buildtype="boost", buildscript="drone", image=linuxglobalimage, environment={'TOOLSET': 'clang', 'COMPILER': 'clang++-3.7', 'CXXSTD': '03,11,14,1z', 'DRONE_JOB_UUID': 'b1d5781111'}, globalenv=globalenv), + linux_cxx("TOOLSET=clang COMPILER=clang++-3.8 CXXSTD=03, Job 11", "clang++-3.8", packages="clang-3.8 libstdc++-4.9-dev", llvm_os="precise", llvm_ver="3.8", buildtype="boost", buildscript="drone", image=linuxglobalimage, environment={'TOOLSET': 'clang', 'COMPILER': 'clang++-3.8', 'CXXSTD': '03,11,14,1z', 'DRONE_JOB_UUID': '17ba079149'}, globalenv=globalenv), + linux_cxx("TOOLSET=clang COMPILER=clang++-3.9 CXXSTD=03, Job 12", "clang++-3.9", packages="clang-3.9 libstdc++-4.9-dev", llvm_os="precise", llvm_ver="3.9", buildtype="boost", buildscript="drone", image=linuxglobalimage, environment={'TOOLSET': 'clang', 'COMPILER': 'clang++-3.9', 'CXXSTD': '03,11,14,1z', 'DRONE_JOB_UUID': '7b52009b64'}, globalenv=globalenv), + linux_cxx("TOOLSET=clang COMPILER=clang++-4.0 CXXSTD=03, Job 13", "clang++-4.0", packages="clang-4.0", llvm_os="trusty", llvm_ver="4.0", buildtype="boost", buildscript="drone", image="cppalliance/droneubuntu1404:1", environment={'TOOLSET': 'clang', 'COMPILER': 'clang++-4.0', 'CXXSTD': '03,11,14,1z', 'DRONE_JOB_UUID': 'bd307a3ec3'}, globalenv=globalenv), + linux_cxx("TOOLSET=clang COMPILER=clang++-5.0 CXXSTD=03, Job 14", "clang++-5.0", packages="clang-5.0", llvm_os="trusty", llvm_ver="5.0", buildtype="boost", buildscript="drone", image="cppalliance/droneubuntu1404:1", environment={'TOOLSET': 'clang', 'COMPILER': 'clang++-5.0', 'CXXSTD': '03,11,14,1z', 'DRONE_JOB_UUID': 'fa35e19212'}, globalenv=globalenv), + osx_cxx("TOOLSET=clang COMPILER=clang++ CXXSTD=03,11,1 Job 15", "clang++", packages="", buildtype="boost", buildscript="drone", environment={'TOOLSET': 'clang', 'COMPILER': 'clang++', 'CXXSTD': '03,11,14,1z', 'DRONE_JOB_UUID': 'f1abd67035'}, globalenv=globalenv), + ] + +# from https://github.com/boostorg/boost-ci +load("@boost_ci//ci/drone/:functions.star", "linux_cxx","windows_cxx","osx_cxx","freebsd_cxx") diff --git a/.drone/drone.sh b/.drone/drone.sh new file mode 100755 index 00000000..a10e6eee --- /dev/null +++ b/.drone/drone.sh @@ -0,0 +1,37 @@ +#!/bin/bash + +# Copyright 2020 Rene Rivera, Sam Darwin +# Distributed under the Boost Software License, Version 1.0. +# (See accompanying file LICENSE.txt or copy at http://boost.org/LICENSE_1_0.txt) + +set -e +export TRAVIS_BUILD_DIR=$(pwd) +export DRONE_BUILD_DIR=$(pwd) +export TRAVIS_BRANCH=$DRONE_BRANCH +export VCS_COMMIT_ID=$DRONE_COMMIT +export GIT_COMMIT=$DRONE_COMMIT +export REPO_NAME=$DRONE_REPO +export PATH=~/.local/bin:/usr/local/bin:$PATH + +if [ "$DRONE_JOB_BUILDTYPE" == "boost" ]; then + +echo '==================================> INSTALL' + +BOOST_BRANCH=develop && [ "$TRAVIS_BRANCH" == "master" ] && BOOST_BRANCH=master || true +cd .. +git clone -b $BOOST_BRANCH --depth 1 https://github.com/boostorg/boost.git boost-root +cd boost-root +git submodule update --init tools/build +git submodule update --init libs/config +git submodule update --init tools/boostdep +cp -r $TRAVIS_BUILD_DIR/* libs/optional +python tools/boostdep/depinst/depinst.py optional +./bootstrap.sh +./b2 headers + +echo '==================================> SCRIPT' + +echo "using $TOOLSET : : $COMPILER ;" > ~/user-config.jam +./b2 libs/optional/test toolset=$TOOLSET cxxstd=$CXXSTD + +fi From 9c9ff5e376d9366576fb3e3fbb529b46100c3380 Mon Sep 17 00:00:00 2001 From: sdarwin Date: Wed, 3 Mar 2021 14:56:21 +0000 Subject: [PATCH 021/163] Add GitHub Actions config [ci skip] --- .github/workflows/ci.yml | 377 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 377 insertions(+) create mode 100644 .github/workflows/ci.yml diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml new file mode 100644 index 00000000..378a30ec --- /dev/null +++ b/.github/workflows/ci.yml @@ -0,0 +1,377 @@ +name: GitHub Actions CI + +on: + pull_request: + push: + branches: + - master + - develop + - githubactions* + - feature/** + - fix/** + - pr/** + +jobs: + posix: + strategy: + fail-fast: false + matrix: + include: + - name: "TOOLSET=gcc COMPILER=g++ CXXSTD=03,11 Job 0" + buildtype: "boost" + packages: "" + packages_to_remove: "" + os: "ubuntu-16.04" + cxx: "g++" + sources: "" + llvm_os: "" + llvm_ver: "" + toolset: "gcc" + compiler: "g++" + cxxstd: "03,11" + - name: "TOOLSET=gcc COMPILER=g++-4.7 CXXSTD=03,11 Job 1" + buildtype: "boost" + packages: "g++-4.7" + packages_to_remove: "" + os: "ubuntu-16.04" + cxx: "g++-4.7" + sources: "" + llvm_os: "" + llvm_ver: "" + toolset: "gcc" + compiler: "g++-4.7" + cxxstd: "03,11" + - name: "TOOLSET=gcc COMPILER=g++-4.8 CXXSTD=03,11 Job 2" + buildtype: "boost" + packages: "g++-4.8" + packages_to_remove: "" + os: "ubuntu-16.04" + cxx: "g++-4.8" + sources: "" + llvm_os: "" + llvm_ver: "" + toolset: "gcc" + compiler: "g++-4.8" + cxxstd: "03,11" + - name: "TOOLSET=gcc COMPILER=g++-4.9 CXXSTD=03,11 Job 3" + buildtype: "boost" + packages: "g++-4.9" + packages_to_remove: "" + os: "ubuntu-16.04" + cxx: "g++-4.9" + sources: "" + llvm_os: "" + llvm_ver: "" + toolset: "gcc" + compiler: "g++-4.9" + cxxstd: "03,11" + - name: "TOOLSET=gcc COMPILER=g++-5 CXXSTD=03,11,14,1z Job 4" + buildtype: "boost" + packages: "g++-5" + packages_to_remove: "" + os: "ubuntu-16.04" + cxx: "g++-5" + sources: "" + llvm_os: "" + llvm_ver: "" + toolset: "gcc" + compiler: "g++-5" + cxxstd: "03,11,14,1z" + - name: "TOOLSET=gcc COMPILER=g++-6 CXXSTD=03,11,14,1z Job 5" + buildtype: "boost" + packages: "g++-6" + packages_to_remove: "" + os: "ubuntu-16.04" + cxx: "g++-6" + sources: "" + llvm_os: "" + llvm_ver: "" + toolset: "gcc" + compiler: "g++-6" + cxxstd: "03,11,14,1z" + - name: "TOOLSET=gcc COMPILER=g++-7 CXXSTD=03,11,14,17 Job 6" + buildtype: "boost" + packages: "g++-7" + packages_to_remove: "" + os: "ubuntu-16.04" + cxx: "g++-7" + sources: "" + llvm_os: "" + llvm_ver: "" + toolset: "gcc" + compiler: "g++-7" + cxxstd: "03,11,14,17" + - name: "TOOLSET=clang COMPILER=clang++ CXXSTD=03,11 Job 7" + buildtype: "boost" + packages: "" + packages_to_remove: "" + os: "ubuntu-16.04" + cxx: "clang++" + sources: "" + llvm_os: "" + llvm_ver: "" + toolset: "clang" + compiler: "clang++" + cxxstd: "03,11" + - name: "TOOLSET=clang COMPILER=clang++-3.5 CXXSTD=03, Job 8" + buildtype: "boost" + packages: "clang-3.5 libstdc++-4.9-dev" + packages_to_remove: "" + os: "ubuntu-16.04" + cxx: "clang++-3.5" + sources: "" + llvm_os: "precise" + llvm_ver: "3.5" + toolset: "clang" + compiler: "clang++-3.5" + cxxstd: "03,11,14" + - name: "TOOLSET=clang COMPILER=clang++-3.6 CXXSTD=03, Job 9" + buildtype: "boost" + packages: "clang-3.6" + packages_to_remove: "" + os: "ubuntu-16.04" + cxx: "clang++-3.6" + sources: "" + llvm_os: "precise" + llvm_ver: "3.6" + toolset: "clang" + compiler: "clang++-3.6" + cxxstd: "03,11,14" + - name: "TOOLSET=clang COMPILER=clang++-3.7 CXXSTD=03, Job 10" + buildtype: "boost" + packages: "clang-3.7" + packages_to_remove: "" + os: "ubuntu-16.04" + cxx: "clang++-3.7" + sources: "" + llvm_os: "precise" + llvm_ver: "3.7" + toolset: "clang" + compiler: "clang++-3.7" + cxxstd: "03,11,14" + - name: "TOOLSET=clang COMPILER=clang++-3.8 CXXSTD=03, Job 11" + buildtype: "boost" + packages: "clang-3.8 libstdc++-4.9-dev" + packages_to_remove: "" + os: "ubuntu-16.04" + cxx: "clang++-3.8" + sources: "" + llvm_os: "precise" + llvm_ver: "3.8" + toolset: "clang" + compiler: "clang++-3.8" + cxxstd: "03,11,14" + - name: "TOOLSET=clang COMPILER=clang++-3.9 CXXSTD=03, Job 12" + buildtype: "boost" + packages: "clang-3.9 libstdc++-4.9-dev" + packages_to_remove: "" + os: "ubuntu-16.04" + cxx: "clang++-3.9" + sources: "" + llvm_os: "precise" + llvm_ver: "3.9" + toolset: "clang" + compiler: "clang++-3.9" + cxxstd: "03,11,14" + - name: "TOOLSET=clang COMPILER=clang++-4.0 CXXSTD=03, Job 13" + buildtype: "boost" + packages: "clang-4.0" + packages_to_remove: "" + os: "ubuntu-16.04" + container: "ubuntu:14.04" + cxx: "clang++-4.0" + sources: "" + llvm_os: "trusty" + llvm_ver: "4.0" + toolset: "clang" + compiler: "clang++-4.0" + cxxstd: "03,11,14" + - name: "TOOLSET=clang COMPILER=clang++-5.0 CXXSTD=03, Job 14" + buildtype: "boost" + packages: "clang-5.0" + packages_to_remove: "" + os: "ubuntu-16.04" + container: "ubuntu:14.04" + cxx: "clang++-5.0" + sources: "" + llvm_os: "trusty" + llvm_ver: "5.0" + toolset: "clang" + compiler: "clang++-5.0" + cxxstd: "03,11,14,1z" + + runs-on: ${{ matrix.os }} + container: ${{ matrix.container }} + + steps: + - name: Check if running in container + if: matrix.container != '' + run: echo "GHA_CONTAINER=${{ matrix.container }}" >> $GITHUB_ENV + - name: If running in container, upgrade packages + if: matrix.container != '' + run: | + sudo apt-get -o Acquire::Retries=3 update && DEBIAN_FRONTEND=noninteractive apt-get -y install tzdata && apt-get -o Acquire::Retries=3 install -y sudo software-properties-common wget curl apt-transport-https make apt-file sudo unzip libssl-dev build-essential autotools-dev autoconf automake g++ libc++-helpers python python-pip ruby cpio gcc-multilib g++-multilib pkgconf python3 python3-pip ccache libpython-dev + sudo apt-add-repository ppa:git-core/ppa + sudo apt-get -o Acquire::Retries=3 update && apt-get -o Acquire::Retries=3 -y install git + sudo python -m pip install --upgrade pip==20.3.4 + sudo /usr/local/bin/pip install cmake + + - uses: actions/checkout@v2 + + - name: linux + shell: bash + env: + CXX: ${{ matrix.cxx }} + SOURCES: ${{ matrix.sources }} + LLVM_OS: ${{ matrix.llvm_os }} + LLVM_VER: ${{ matrix.llvm_ver }} + PACKAGES: ${{ matrix.packages }} + PACKAGES_TO_REMOVE: ${{ matrix.packages_to_remove }} + JOB_BUILDTYPE: ${{ matrix.buildtype }} + TOOLSET: ${{ matrix.toolset }} + COMPILER: ${{ matrix.compiler }} + CXXSTD: ${{ matrix.cxxstd }} + TRAVIS_BRANCH: ${{ github.base_ref }} + TRAVIS_OS_NAME: "linux" + run: | + echo '==================================> SETUP' + echo '==================================> PACKAGES' + set -e + if [ -n "$PACKAGES_TO_REMOVE" ]; then sudo apt-get purge -y $PACKAGES_TO_REMOVE; fi + echo ">>>>> APT: REPO.." + for i in {1..3}; do sudo -E apt-add-repository -y "ppa:ubuntu-toolchain-r/test" && break || sleep 2; done + + if test -n "${LLVM_OS}" ; then + wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add - + if test -n "${LLVM_VER}" ; then + sudo -E apt-add-repository "deb http://apt.llvm.org/${LLVM_OS}/ llvm-toolchain-${LLVM_OS}-${LLVM_VER} main" + else + # Snapshot (i.e. trunk) build of clang + sudo -E apt-add-repository "deb http://apt.llvm.org/${LLVM_OS}/ llvm-toolchain-${LLVM_OS} main" + fi + fi + echo ">>>>> APT: UPDATE.." + sudo -E apt-get -o Acquire::Retries=3 update + if test -n "${SOURCES}" ; then + echo ">>>>> APT: INSTALL SOURCES.." + for SOURCE in $SOURCES; do + sudo -E apt-add-repository ppa:$SOURCE + done + fi + echo ">>>>> APT: INSTALL ${PACKAGES}.." + sudo -E DEBIAN_FRONTEND=noninteractive apt-get -o Acquire::Retries=3 -y --no-install-suggests --no-install-recommends install ${PACKAGES} + + echo '==================================> INSTALL AND COMPILE' + set -e + export TRAVIS_BUILD_DIR=$(pwd) + export TRAVIS_BRANCH=${TRAVIS_BRANCH:-$(echo $GITHUB_REF | awk 'BEGIN { FS = "/" } ; { print $3 }')} + export VCS_COMMIT_ID=$GITHUB_SHA + export GIT_COMMIT=$GITHUB_SHA + export REPO_NAME=$(basename $GITHUB_REPOSITORY) + export USER=$(whoami) + export CC=${CC:-gcc} + export PATH=~/.local/bin:/usr/local/bin:$PATH + + if [ "$JOB_BUILDTYPE" == "boost" ]; then + + echo '==================================> INSTALL' + + BOOST_BRANCH=develop && [ "$TRAVIS_BRANCH" == "master" ] && BOOST_BRANCH=master || true + cd .. + git clone -b $BOOST_BRANCH --depth 1 https://github.com/boostorg/boost.git boost-root + cd boost-root + git submodule update --init tools/build + git submodule update --init libs/config + git submodule update --init tools/boostdep + cp -r $TRAVIS_BUILD_DIR/* libs/optional + python tools/boostdep/depinst/depinst.py optional + ./bootstrap.sh + ./b2 headers + + echo '==================================> SCRIPT' + + echo "using $TOOLSET : : $COMPILER ;" > ~/user-config.jam + ./b2 libs/optional/test toolset=$TOOLSET cxxstd=$CXXSTD + + fi + osx: + strategy: + fail-fast: false + matrix: + include: + - name: "TOOLSET=clang COMPILER=clang++ CXXSTD=03,11,1 Job 15" + buildtype: "boost" + packages: "" + os: "macos-10.15" + cxx: "clang++" + sources: "" + llvm_os: "" + llvm_ver: "" + xcode_version: 11.7 + toolset: "clang" + compiler: "clang++" + cxxstd: "03,11,14,1z" + + runs-on: ${{ matrix.os }} + + steps: + - uses: actions/checkout@v2 + + - name: Set DEVELOPER_DIR + if: matrix.xcode_version != '' + run: echo "DEVELOPER_DIR=/Applications/Xcode_${{ matrix.xcode_version }}.app/Contents/Developer" >> $GITHUB_ENV + - name: Test DEVELOPER_DIR + run: echo $DEVELOPER_DIR + + - name: "osx" + shell: bash + env: + CXX: ${{ matrix.cxx }} + SOURCES: ${{ matrix.sources }} + LLVM_OS: ${{ matrix.llvm_os }} + LLVM_VER: ${{ matrix.llvm_ver }} + PACKAGES: ${{ matrix.packages }} + JOB_BUILDTYPE: ${{ matrix.buildtype }} + TOOLSET: ${{ matrix.toolset }} + COMPILER: ${{ matrix.compiler }} + CXXSTD: ${{ matrix.cxxstd }} + TRAVIS_BRANCH: ${{ github.base_ref }} + TRAVIS_OS_NAME: "osx" + run: | + echo '==================================> SETUP' + set -e + sudo mv /Library/Developer/CommandLineTools /Library/Developer/CommandLineTools.bck + echo '==================================> PACKAGES' + echo '==================================> INSTALL AND COMPILE' + set -e + export TRAVIS_BUILD_DIR=$(pwd) + export TRAVIS_BRANCH=${TRAVIS_BRANCH:-$(echo $GITHUB_REF | awk 'BEGIN { FS = "/" } ; { print $3 }')} + export VCS_COMMIT_ID=$GITHUB_SHA + export GIT_COMMIT=$GITHUB_SHA + export REPO_NAME=$(basename $GITHUB_REPOSITORY) + export USER=$(whoami) + export CC=${CC:-gcc} + export PATH=~/.local/bin:/usr/local/bin:$PATH + + if [ "$JOB_BUILDTYPE" == "boost" ]; then + + echo '==================================> INSTALL' + + BOOST_BRANCH=develop && [ "$TRAVIS_BRANCH" == "master" ] && BOOST_BRANCH=master || true + cd .. + git clone -b $BOOST_BRANCH --depth 1 https://github.com/boostorg/boost.git boost-root + cd boost-root + git submodule update --init tools/build + git submodule update --init libs/config + git submodule update --init tools/boostdep + cp -r $TRAVIS_BUILD_DIR/* libs/optional + python tools/boostdep/depinst/depinst.py optional + ./bootstrap.sh + ./b2 headers + + echo '==================================> SCRIPT' + + echo "using $TOOLSET : : $COMPILER ;" > ~/user-config.jam + ./b2 libs/optional/test toolset=$TOOLSET cxxstd=$CXXSTD + + fi From 5a444eb84b67a5035e3577476234189c57ca55c1 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Wed, 10 Mar 2021 23:07:18 +0100 Subject: [PATCH 022/163] docs: updated copyright notice --- doc/00_optional.qbk | 2 +- doc/html/boost_optional/acknowledgements.html | 2 +- doc/html/boost_optional/dependencies_and_portability.html | 2 +- .../emplace_operations_in_older_compilers.html | 2 +- .../optional_reference_binding.html | 2 +- doc/html/boost_optional/quick_start.html | 2 +- .../bypassing_unnecessary_default_construction.html | 2 +- .../quick_start/optional_automatic_variables.html | 2 +- .../boost_optional/quick_start/optional_data_members.html | 2 +- .../boost_optional/quick_start/storage_in_containers.html | 2 +- .../header__boost_optional_bad_optional_access_hpp_.html | 2 +- .../detailed_semantics.html | 2 +- .../boost_optional/reference/header__boost_optional_hpp_.html | 2 +- .../reference/header__boost_optional_optional_fwd_hpp_.html | 2 +- .../detailed_semantics___free_functions.html | 2 +- .../detailed_semantics___optional_references.html | 2 +- .../detailed_semantics___optional_values.html | 2 +- .../header_optional_in_place_init.html | 2 +- .../header_optional_optional_refs.html | 2 +- .../header_optional_optional_values.html | 2 +- doc/html/boost_optional/reference/io_header.html | 2 +- doc/html/boost_optional/reference/io_header/io_semantics.html | 2 +- doc/html/boost_optional/relnotes.html | 2 +- doc/html/boost_optional/tutorial/design_overview.html | 2 +- .../tutorial/design_overview/the_interface.html | 2 +- .../tutorial/design_overview/the_semantics.html | 2 +- .../boost_optional/tutorial/exception_safety_guarantees.html | 2 +- doc/html/boost_optional/tutorial/gotchas.html | 2 +- .../gotchas/false_positive_with__wmaybe_uninitialized.html | 2 +- .../tutorial/gotchas/mixed_relational_comparisons.html | 2 +- .../tutorial/gotchas/moved_from__optional_.html | 2 +- doc/html/boost_optional/tutorial/in_place_factories.html | 2 +- doc/html/boost_optional/tutorial/io_operators.html | 2 +- doc/html/boost_optional/tutorial/optional_references.html | 2 +- ...nding_semantics_for_assignment_of_optional_references.html | 2 +- .../boost_optional/tutorial/performance_considerations.html | 2 +- doc/html/boost_optional/tutorial/relational_operators.html | 2 +- doc/html/boost_optional/tutorial/type_requirements.html | 2 +- doc/html/boost_optional/tutorial/when_to_use_optional.html | 2 +- doc/html/index.html | 4 ++-- doc/html/optional/reference.html | 2 +- .../reference/header__boost_optional_optional_hpp_.html | 2 +- doc/html/optional/tutorial.html | 2 +- 43 files changed, 44 insertions(+), 44 deletions(-) diff --git a/doc/00_optional.qbk b/doc/00_optional.qbk index fd7d014b..e48c8e4d 100644 --- a/doc/00_optional.qbk +++ b/doc/00_optional.qbk @@ -2,7 +2,7 @@ [quickbook 1.4] [authors [Cacciola Carballal, Fernando Luis]] [copyright 2003-2007 Fernando Luis Cacciola Carballal] - [copyright 2014-2020 Andrzej Krzemieński] + [copyright 2014-2021 Andrzej Krzemieński] [category miscellaneous] [id optional] [dirname optional] diff --git a/doc/html/boost_optional/acknowledgements.html b/doc/html/boost_optional/acknowledgements.html index 56c6f5c2..54195804 100644 --- a/doc/html/boost_optional/acknowledgements.html +++ b/doc/html/boost_optional/acknowledgements.html @@ -116,7 +116,7 @@

      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/dependencies_and_portability.html b/doc/html/boost_optional/dependencies_and_portability.html index c7a3d63d..2b4f7c43 100644 --- a/doc/html/boost_optional/dependencies_and_portability.html +++ b/doc/html/boost_optional/dependencies_and_portability.html @@ -77,7 +77,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html b/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html index 55ba5d89..49cf74a6 100644 --- a/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html +++ b/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html @@ -76,7 +76,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html b/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html index 3a631f98..a25f2b0b 100644 --- a/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html +++ b/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html @@ -93,7 +93,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/quick_start.html b/doc/html/boost_optional/quick_start.html index 3aa15bae..dd8491aa 100644 --- a/doc/html/boost_optional/quick_start.html +++ b/doc/html/boost_optional/quick_start.html @@ -155,7 +155,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html b/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html index db986ce9..b49c8abe 100644 --- a/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html +++ b/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html @@ -61,7 +61,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/quick_start/optional_automatic_variables.html b/doc/html/boost_optional/quick_start/optional_automatic_variables.html index d6fcacbb..54b48357 100644 --- a/doc/html/boost_optional/quick_start/optional_automatic_variables.html +++ b/doc/html/boost_optional/quick_start/optional_automatic_variables.html @@ -61,7 +61,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/quick_start/optional_data_members.html b/doc/html/boost_optional/quick_start/optional_data_members.html index 646746a6..32684053 100644 --- a/doc/html/boost_optional/quick_start/optional_data_members.html +++ b/doc/html/boost_optional/quick_start/optional_data_members.html @@ -80,7 +80,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/quick_start/storage_in_containers.html b/doc/html/boost_optional/quick_start/storage_in_containers.html index 77f70143..95809140 100644 --- a/doc/html/boost_optional/quick_start/storage_in_containers.html +++ b/doc/html/boost_optional/quick_start/storage_in_containers.html @@ -50,7 +50,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html index e2a7d6d1..f5b40337 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html +++ b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html @@ -49,7 +49,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html index 451b14e2..eea25e98 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html +++ b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html @@ -46,7 +46,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_hpp_.html index 52af3272..8390a062 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_hpp_.html +++ b/doc/html/boost_optional/reference/header__boost_optional_hpp_.html @@ -33,7 +33,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html index e7ed5e1e..45d55b27 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html @@ -52,7 +52,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html index b7ff68f7..2781080e 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html @@ -507,7 +507,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html index 12a865e5..cbc3d647 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html @@ -538,7 +538,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html index 712e3871..b6e02272 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html @@ -1774,7 +1774,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html index 01a05e7e..50841642 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html @@ -47,7 +47,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html index 7da08d96..34729158 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html @@ -104,7 +104,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html index 2d188679..80d648a6 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html @@ -139,7 +139,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/io_header.html b/doc/html/boost_optional/reference/io_header.html index 6c9dcdca..9b33523a 100644 --- a/doc/html/boost_optional/reference/io_header.html +++ b/doc/html/boost_optional/reference/io_header.html @@ -58,7 +58,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/io_header/io_semantics.html b/doc/html/boost_optional/reference/io_header/io_semantics.html index 15b199f6..f74ff4ac 100644 --- a/doc/html/boost_optional/reference/io_header/io_semantics.html +++ b/doc/html/boost_optional/reference/io_header/io_semantics.html @@ -98,7 +98,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/relnotes.html b/doc/html/boost_optional/relnotes.html index db4c583a..71130514 100644 --- a/doc/html/boost_optional/relnotes.html +++ b/doc/html/boost_optional/relnotes.html @@ -342,7 +342,7 @@

      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/design_overview.html b/doc/html/boost_optional/tutorial/design_overview.html index d088659f..c467658c 100644 --- a/doc/html/boost_optional/tutorial/design_overview.html +++ b/doc/html/boost_optional/tutorial/design_overview.html @@ -170,7 +170,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/design_overview/the_interface.html b/doc/html/boost_optional/tutorial/design_overview/the_interface.html index 2b25c711..f0bbc860 100644 --- a/doc/html/boost_optional/tutorial/design_overview/the_interface.html +++ b/doc/html/boost_optional/tutorial/design_overview/the_interface.html @@ -173,7 +173,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/design_overview/the_semantics.html b/doc/html/boost_optional/tutorial/design_overview/the_semantics.html index 16436a50..58e52267 100644 --- a/doc/html/boost_optional/tutorial/design_overview/the_semantics.html +++ b/doc/html/boost_optional/tutorial/design_overview/the_semantics.html @@ -107,7 +107,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/exception_safety_guarantees.html b/doc/html/boost_optional/tutorial/exception_safety_guarantees.html index 4d6ffd21..cca3e8cd 100644 --- a/doc/html/boost_optional/tutorial/exception_safety_guarantees.html +++ b/doc/html/boost_optional/tutorial/exception_safety_guarantees.html @@ -161,7 +161,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas.html b/doc/html/boost_optional/tutorial/gotchas.html index a01b3d1d..9382442d 100644 --- a/doc/html/boost_optional/tutorial/gotchas.html +++ b/doc/html/boost_optional/tutorial/gotchas.html @@ -98,7 +98,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html b/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html index 4055b916..0a719296 100644 --- a/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html +++ b/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html @@ -63,7 +63,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html b/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html index 082c6c6b..8771851b 100644 --- a/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html +++ b/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html @@ -45,7 +45,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html b/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html index 95499944..5c4b1cf2 100644 --- a/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html +++ b/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html @@ -49,7 +49,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/in_place_factories.html b/doc/html/boost_optional/tutorial/in_place_factories.html index 37c76cdc..10e62baa 100644 --- a/doc/html/boost_optional/tutorial/in_place_factories.html +++ b/doc/html/boost_optional/tutorial/in_place_factories.html @@ -183,7 +183,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/io_operators.html b/doc/html/boost_optional/tutorial/io_operators.html index 2afb07d7..d6d9dcbd 100644 --- a/doc/html/boost_optional/tutorial/io_operators.html +++ b/doc/html/boost_optional/tutorial/io_operators.html @@ -73,7 +73,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/optional_references.html b/doc/html/boost_optional/tutorial/optional_references.html index 8c9e2168..595303ee 100644 --- a/doc/html/boost_optional/tutorial/optional_references.html +++ b/doc/html/boost_optional/tutorial/optional_references.html @@ -103,7 +103,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html b/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html index 4581faee..112eb5da 100644 --- a/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html +++ b/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html @@ -133,7 +133,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/performance_considerations.html b/doc/html/boost_optional/tutorial/performance_considerations.html index f486628b..975a7388 100644 --- a/doc/html/boost_optional/tutorial/performance_considerations.html +++ b/doc/html/boost_optional/tutorial/performance_considerations.html @@ -251,7 +251,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/relational_operators.html b/doc/html/boost_optional/tutorial/relational_operators.html index f618bc74..ddb68707 100644 --- a/doc/html/boost_optional/tutorial/relational_operators.html +++ b/doc/html/boost_optional/tutorial/relational_operators.html @@ -99,7 +99,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/type_requirements.html b/doc/html/boost_optional/tutorial/type_requirements.html index 172e1894..9eac69df 100644 --- a/doc/html/boost_optional/tutorial/type_requirements.html +++ b/doc/html/boost_optional/tutorial/type_requirements.html @@ -95,7 +95,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/when_to_use_optional.html b/doc/html/boost_optional/tutorial/when_to_use_optional.html index 66e18051..7fa6810e 100644 --- a/doc/html/boost_optional/tutorial/when_to_use_optional.html +++ b/doc/html/boost_optional/tutorial/when_to_use_optional.html @@ -128,7 +128,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/index.html b/doc/html/index.html index f97beec0..56f5f860 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -26,7 +26,7 @@ Fernando Luis Cacciola Carballal

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal

      -

      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying @@ -145,7 +145,7 @@

      - +

      Last revised: December 18, 2020 at 22:54:39 GMT

      Last revised: March 10, 2021 at 22:06:01 GMT
      diff --git a/doc/html/optional/reference.html b/doc/html/optional/reference.html index 8ab0bfeb..1cbeafab 100644 --- a/doc/html/optional/reference.html +++ b/doc/html/optional/reference.html @@ -75,7 +75,7 @@ -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/optional/reference/header__boost_optional_optional_hpp_.html b/doc/html/optional/reference/header__boost_optional_optional_hpp_.html index 7d3e3456..c905bfce 100644 --- a/doc/html/optional/reference/header__boost_optional_optional_hpp_.html +++ b/doc/html/optional/reference/header__boost_optional_optional_hpp_.html @@ -97,7 +97,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/optional/tutorial.html b/doc/html/optional/tutorial.html index 57e3c089..1331750c 100644 --- a/doc/html/optional/tutorial.html +++ b/doc/html/optional/tutorial.html @@ -139,7 +139,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      From d0ab8004c016dc71366f6624856595713df061ae Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Wed, 19 May 2021 23:29:10 +0200 Subject: [PATCH 023/163] Add support for BOOST_NO_IOSTREAM --- doc/91_relnotes.qbk | 4 +++ doc/html/boost_optional/relnotes.html | 37 ++++++++++++++++---------- doc/html/index.html | 2 +- include/boost/optional/optional.hpp | 4 +++ include/boost/optional/optional_io.hpp | 5 ++-- test/optional_test.cpp | 6 ++--- test/optional_test_io.cpp | 19 ++++++++++--- 7 files changed, 54 insertions(+), 23 deletions(-) diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index 82dad14b..3c1736ae 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -11,6 +11,10 @@ [section:relnotes Release Notes] +[heading Boost Release 1.77] + +* Fixed [@https://github.com/boostorg/optional/issues/92 issue #92]. + [heading Boost Release 1.76] * Fixed MSVC warning C4702. diff --git a/doc/html/boost_optional/relnotes.html b/doc/html/boost_optional/relnotes.html index f973c6df..560e7283 100644 --- a/doc/html/boost_optional/relnotes.html +++ b/doc/html/boost_optional/relnotes.html @@ -28,6 +28,15 @@

      + Boost + Release 1.77 +

      +
      +

      + Boost Release 1.76

      @@ -35,7 +44,7 @@

      Fixed MSVC warning C4702.

      - + Boost Release 1.75

      @@ -49,7 +58,7 @@

      - + Boost Release 1.73

      @@ -72,7 +81,7 @@

      - + Boost Release 1.69

      @@ -90,7 +99,7 @@

      - + Boost Release 1.68

      @@ -107,7 +116,7 @@

      - + Boost Release 1.67

      @@ -121,7 +130,7 @@

      - + Boost Release 1.66

      @@ -139,7 +148,7 @@

      - + Boost Release 1.63

      @@ -163,7 +172,7 @@

      - + Boost Release 1.62

      @@ -171,7 +180,7 @@

      Fixed Trac #12179.

      - + Boost Release 1.61

      @@ -214,7 +223,7 @@

      - + Boost Release 1.60

      @@ -225,7 +234,7 @@

      #11203.

      - + Boost Release 1.59

      @@ -239,7 +248,7 @@

      - + Boost Release 1.58

      @@ -275,7 +284,7 @@

      - + Boost Release 1.57

      @@ -285,7 +294,7 @@

      to fix C++03 compile error on logic_error("...")".

      - + Boost Release 1.56

      diff --git a/doc/html/index.html b/doc/html/index.html index f97beec0..98420b8f 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -145,7 +145,7 @@

      - +

      Last revised: December 18, 2020 at 22:54:39 GMT

      Last revised: May 19, 2021 at 21:27:41 GMT
      diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index aadc975a..1c30327e 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -18,7 +18,9 @@ #define BOOST_OPTIONAL_OPTIONAL_FLC_19NOV2002_HPP #include +#ifndef BOOST_NO_IOSTREAM #include +#endif // BOOST_NO_IOSTREAM #ifdef BOOST_OPTIONAL_DETAIL_USE_STD_TYPE_TRAITS # include @@ -1586,6 +1588,7 @@ get_pointer ( optional& opt ) } // namespace boost +#ifndef BOOST_NO_IOSTREAM namespace boost { // The following declaration prevents a bug where operator safe-bool is used upon streaming optional object if you forget the IO header. @@ -1598,6 +1601,7 @@ operator<<(std::basic_ostream& os, optional_detail::optiona } } // namespace boost +#endif // BOOST_NO_IOSTREAM #include #include diff --git a/include/boost/optional/optional_io.hpp b/include/boost/optional/optional_io.hpp index ce81b68f..3db6ddae 100644 --- a/include/boost/optional/optional_io.hpp +++ b/include/boost/optional/optional_io.hpp @@ -12,6 +12,7 @@ #ifndef BOOST_OPTIONAL_OPTIONAL_IO_FLC_19NOV2002_HPP #define BOOST_OPTIONAL_OPTIONAL_IO_FLC_19NOV2002_HPP +#ifndef BOOST_NO_IOSTREAM #include #include @@ -31,7 +32,7 @@ operator<<(std::basic_ostream& out, none_t) { out << "--"; } - + return out; } @@ -90,5 +91,5 @@ operator>>(std::basic_istream& in, optional& v) } // namespace boost +#endif // BOOST_NO_IOSTREAM #endif - diff --git a/test/optional_test.cpp b/test/optional_test.cpp index a0fa5a6d..f5ca4369 100644 --- a/test/optional_test.cpp +++ b/test/optional_test.cpp @@ -12,7 +12,9 @@ // Revisions: // 12 May 2008 (added more swap tests) // +#ifndef BOOST_NO_IOSTREAM #include +#endif // BOOST_NO_IOSTREAM #include #include @@ -908,7 +910,7 @@ void test_no_implicit_conversions() // Test for support for classes with overridden operator& -class CustomAddressOfClass +class CustomAddressOfClass { int n; @@ -950,5 +952,3 @@ int main() return boost::report_errors(); } - - diff --git a/test/optional_test_io.cpp b/test/optional_test_io.cpp index 14c2b26f..8086c11c 100644 --- a/test/optional_test_io.cpp +++ b/test/optional_test_io.cpp @@ -10,15 +10,19 @@ // You are welcome to contact the author at: // fernando_cacciola@hotmail.com -#include #include "boost/optional/optional.hpp" #include "boost/optional/optional_io.hpp" +#include "boost/core/lightweight_test.hpp" + +#ifndef BOOST_NO_IOSTREAM + +#include #ifdef BOOST_BORLANDC #pragma hdrstop #endif -#include "boost/core/lightweight_test.hpp" + using boost::optional; @@ -29,7 +33,7 @@ void test2( Opt o, Opt buff ) const int markv = 123 ; int mark = 0 ; - + s << o << " " << markv ; s >> buff >> mark ; @@ -85,3 +89,12 @@ int main() return boost::report_errors(); } + +#else // BOOST_NO_IOSTREAM + +int main() +{ + return boost::report_errors(); +} + +#endif // BOOST_NO_IOSTREAM From 0b159febf8c43ac3124df4bfa722c450a8ffd718 Mon Sep 17 00:00:00 2001 From: Peter Dimov Date: Thu, 10 Jun 2021 00:53:07 +0300 Subject: [PATCH 024/163] Update CMakeLists.txt --- CMakeLists.txt | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index 3c836a4c..f60acf55 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,12 +1,9 @@ # Copyright 2019 Mike Dev # Distributed under the Boost Software License, Version 1.0. # See accompanying file LICENSE_1_0.txt or copy at https://www.boost.org/LICENSE_1_0.txt -# -# NOTE: CMake support for Boost.Optional is currently experimental at best -# and the interface is likely to change in the future -cmake_minimum_required( VERSION 3.5 ) -project( BoostOptional ) +cmake_minimum_required( VERSION 3.5...3.20 ) +project( boost_optional VERSION "${BOOST_SUPERPROJECT_VERSION}" LANGUAGES CXX ) add_library( boost_optional INTERFACE ) add_library( Boost::optional ALIAS boost_optional ) From 14d43d2e6e2bf14a0d5b207c14d6fe710ada265c Mon Sep 17 00:00:00 2001 From: sdarwin Date: Fri, 30 Jul 2021 16:10:11 +0000 Subject: [PATCH 025/163] Update GitHub Actions CI file --- .github/workflows/ci.yml | 48 ++++++++++++++++++++++++++-------------- 1 file changed, 31 insertions(+), 17 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 378a30ec..ec7e4cbc 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -21,7 +21,8 @@ jobs: buildtype: "boost" packages: "" packages_to_remove: "" - os: "ubuntu-16.04" + os: "ubuntu-20.04" + container: "ubuntu:16.04" cxx: "g++" sources: "" llvm_os: "" @@ -33,7 +34,8 @@ jobs: buildtype: "boost" packages: "g++-4.7" packages_to_remove: "" - os: "ubuntu-16.04" + os: "ubuntu-20.04" + container: "ubuntu:16.04" cxx: "g++-4.7" sources: "" llvm_os: "" @@ -45,7 +47,8 @@ jobs: buildtype: "boost" packages: "g++-4.8" packages_to_remove: "" - os: "ubuntu-16.04" + os: "ubuntu-20.04" + container: "ubuntu:16.04" cxx: "g++-4.8" sources: "" llvm_os: "" @@ -57,7 +60,8 @@ jobs: buildtype: "boost" packages: "g++-4.9" packages_to_remove: "" - os: "ubuntu-16.04" + os: "ubuntu-20.04" + container: "ubuntu:16.04" cxx: "g++-4.9" sources: "" llvm_os: "" @@ -69,7 +73,8 @@ jobs: buildtype: "boost" packages: "g++-5" packages_to_remove: "" - os: "ubuntu-16.04" + os: "ubuntu-20.04" + container: "ubuntu:16.04" cxx: "g++-5" sources: "" llvm_os: "" @@ -81,7 +86,8 @@ jobs: buildtype: "boost" packages: "g++-6" packages_to_remove: "" - os: "ubuntu-16.04" + os: "ubuntu-20.04" + container: "ubuntu:16.04" cxx: "g++-6" sources: "" llvm_os: "" @@ -93,7 +99,8 @@ jobs: buildtype: "boost" packages: "g++-7" packages_to_remove: "" - os: "ubuntu-16.04" + os: "ubuntu-20.04" + container: "ubuntu:16.04" cxx: "g++-7" sources: "" llvm_os: "" @@ -105,7 +112,7 @@ jobs: buildtype: "boost" packages: "" packages_to_remove: "" - os: "ubuntu-16.04" + os: "ubuntu-18.04" cxx: "clang++" sources: "" llvm_os: "" @@ -117,7 +124,8 @@ jobs: buildtype: "boost" packages: "clang-3.5 libstdc++-4.9-dev" packages_to_remove: "" - os: "ubuntu-16.04" + os: "ubuntu-20.04" + container: "ubuntu:16.04" cxx: "clang++-3.5" sources: "" llvm_os: "precise" @@ -129,7 +137,8 @@ jobs: buildtype: "boost" packages: "clang-3.6" packages_to_remove: "" - os: "ubuntu-16.04" + os: "ubuntu-20.04" + container: "ubuntu:16.04" cxx: "clang++-3.6" sources: "" llvm_os: "precise" @@ -141,7 +150,8 @@ jobs: buildtype: "boost" packages: "clang-3.7" packages_to_remove: "" - os: "ubuntu-16.04" + os: "ubuntu-20.04" + container: "ubuntu:16.04" cxx: "clang++-3.7" sources: "" llvm_os: "precise" @@ -153,7 +163,8 @@ jobs: buildtype: "boost" packages: "clang-3.8 libstdc++-4.9-dev" packages_to_remove: "" - os: "ubuntu-16.04" + os: "ubuntu-20.04" + container: "ubuntu:16.04" cxx: "clang++-3.8" sources: "" llvm_os: "precise" @@ -165,7 +176,8 @@ jobs: buildtype: "boost" packages: "clang-3.9 libstdc++-4.9-dev" packages_to_remove: "" - os: "ubuntu-16.04" + os: "ubuntu-20.04" + container: "ubuntu:16.04" cxx: "clang++-3.9" sources: "" llvm_os: "precise" @@ -177,7 +189,7 @@ jobs: buildtype: "boost" packages: "clang-4.0" packages_to_remove: "" - os: "ubuntu-16.04" + os: "ubuntu-20.04" container: "ubuntu:14.04" cxx: "clang++-4.0" sources: "" @@ -190,7 +202,7 @@ jobs: buildtype: "boost" packages: "clang-5.0" packages_to_remove: "" - os: "ubuntu-16.04" + os: "ubuntu-20.04" container: "ubuntu:14.04" cxx: "clang++-5.0" sources: "" @@ -210,10 +222,12 @@ jobs: - name: If running in container, upgrade packages if: matrix.container != '' run: | - sudo apt-get -o Acquire::Retries=3 update && DEBIAN_FRONTEND=noninteractive apt-get -y install tzdata && apt-get -o Acquire::Retries=3 install -y sudo software-properties-common wget curl apt-transport-https make apt-file sudo unzip libssl-dev build-essential autotools-dev autoconf automake g++ libc++-helpers python python-pip ruby cpio gcc-multilib g++-multilib pkgconf python3 python3-pip ccache libpython-dev + apt-get -o Acquire::Retries=3 update && DEBIAN_FRONTEND=noninteractive apt-get -y install tzdata && apt-get -o Acquire::Retries=3 install -y sudo software-properties-common wget curl apt-transport-https make apt-file sudo unzip libssl-dev build-essential autotools-dev autoconf automake g++ libc++-helpers python ruby cpio gcc-multilib g++-multilib pkgconf python3 ccache libpython-dev sudo apt-add-repository ppa:git-core/ppa sudo apt-get -o Acquire::Retries=3 update && apt-get -o Acquire::Retries=3 -y install git - sudo python -m pip install --upgrade pip==20.3.4 + python_version=$(python3 -c 'import sys; print("{0.major}.{0.minor}".format(sys.version_info))') + sudo wget https://bootstrap.pypa.io/pip/$python_version/get-pip.py + sudo python3 get-pip.py sudo /usr/local/bin/pip install cmake - uses: actions/checkout@v2 From 7dd512a0196205f45a481bbbc302f8bf4d92626e Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Sat, 20 Nov 2021 02:00:30 +0100 Subject: [PATCH 026/163] Fix issue #98 --- doc/00_optional.qbk | 2 +- doc/91_relnotes.qbk | 6 +- doc/html/boost_optional/acknowledgements.html | 2 +- .../dependencies_and_portability.html | 2 +- ...emplace_operations_in_older_compilers.html | 2 +- .../optional_reference_binding.html | 2 +- doc/html/boost_optional/quick_start.html | 2 +- ...sing_unnecessary_default_construction.html | 2 +- .../optional_automatic_variables.html | 2 +- .../quick_start/optional_data_members.html | 2 +- .../quick_start/storage_in_containers.html | 2 +- ...ost_optional_bad_optional_access_hpp_.html | 2 +- .../detailed_semantics.html | 2 +- .../header__boost_optional_hpp_.html | 2 +- ...der__boost_optional_optional_fwd_hpp_.html | 2 +- .../detailed_semantics___free_functions.html | 2 +- ...ailed_semantics___optional_references.html | 2 +- .../detailed_semantics___optional_values.html | 2 +- .../header_optional_in_place_init.html | 2 +- .../header_optional_optional_refs.html | 2 +- .../header_optional_optional_values.html | 2 +- .../boost_optional/reference/io_header.html | 2 +- .../reference/io_header/io_semantics.html | 2 +- doc/html/boost_optional/relnotes.html | 41 ++++++---- .../tutorial/design_overview.html | 2 +- .../design_overview/the_interface.html | 2 +- .../design_overview/the_semantics.html | 2 +- .../tutorial/exception_safety_guarantees.html | 2 +- doc/html/boost_optional/tutorial/gotchas.html | 2 +- ...e_positive_with__wmaybe_uninitialized.html | 2 +- .../gotchas/mixed_relational_comparisons.html | 2 +- .../gotchas/moved_from__optional_.html | 2 +- .../tutorial/in_place_factories.html | 2 +- .../boost_optional/tutorial/io_operators.html | 2 +- .../tutorial/optional_references.html | 2 +- ...for_assignment_of_optional_references.html | 2 +- .../tutorial/performance_considerations.html | 2 +- .../tutorial/relational_operators.html | 2 +- .../tutorial/type_requirements.html | 2 +- .../tutorial/when_to_use_optional.html | 2 +- doc/html/index.html | 4 +- doc/html/optional/reference.html | 2 +- .../header__boost_optional_optional_hpp_.html | 2 +- doc/html/optional/tutorial.html | 2 +- include/boost/optional/optional.hpp | 79 ++++++++++++++++--- test/Jamfile.v2 | 1 + test/optional_test_convert_assign.cpp | 57 +++++++++++++ 47 files changed, 198 insertions(+), 72 deletions(-) create mode 100644 test/optional_test_convert_assign.cpp diff --git a/doc/00_optional.qbk b/doc/00_optional.qbk index fd7d014b..e48c8e4d 100644 --- a/doc/00_optional.qbk +++ b/doc/00_optional.qbk @@ -2,7 +2,7 @@ [quickbook 1.4] [authors [Cacciola Carballal, Fernando Luis]] [copyright 2003-2007 Fernando Luis Cacciola Carballal] - [copyright 2014-2020 Andrzej Krzemieński] + [copyright 2014-2021 Andrzej Krzemieński] [category miscellaneous] [id optional] [dirname optional] diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index 3c1736ae..d61b289f 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -1,7 +1,7 @@ [/ Boost.Optional - Copyright (c) 2015 - 2018 Andrzej Krzemienski + Copyright (c) 2015 - 2021 Andrzej Krzemienski Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at @@ -11,6 +11,10 @@ [section:relnotes Release Notes] +[heading Boost Release 1.79] + +* Fixed [@https://github.com/boostorg/optional/issues/98 issue #98]. + [heading Boost Release 1.77] * Fixed [@https://github.com/boostorg/optional/issues/92 issue #92]. diff --git a/doc/html/boost_optional/acknowledgements.html b/doc/html/boost_optional/acknowledgements.html index 56c6f5c2..54195804 100644 --- a/doc/html/boost_optional/acknowledgements.html +++ b/doc/html/boost_optional/acknowledgements.html @@ -116,7 +116,7 @@

      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/dependencies_and_portability.html b/doc/html/boost_optional/dependencies_and_portability.html index c7a3d63d..2b4f7c43 100644 --- a/doc/html/boost_optional/dependencies_and_portability.html +++ b/doc/html/boost_optional/dependencies_and_portability.html @@ -77,7 +77,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html b/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html index 55ba5d89..49cf74a6 100644 --- a/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html +++ b/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html @@ -76,7 +76,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html b/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html index 3a631f98..a25f2b0b 100644 --- a/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html +++ b/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html @@ -93,7 +93,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/quick_start.html b/doc/html/boost_optional/quick_start.html index 3aa15bae..dd8491aa 100644 --- a/doc/html/boost_optional/quick_start.html +++ b/doc/html/boost_optional/quick_start.html @@ -155,7 +155,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html b/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html index db986ce9..b49c8abe 100644 --- a/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html +++ b/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html @@ -61,7 +61,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/quick_start/optional_automatic_variables.html b/doc/html/boost_optional/quick_start/optional_automatic_variables.html index d6fcacbb..54b48357 100644 --- a/doc/html/boost_optional/quick_start/optional_automatic_variables.html +++ b/doc/html/boost_optional/quick_start/optional_automatic_variables.html @@ -61,7 +61,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/quick_start/optional_data_members.html b/doc/html/boost_optional/quick_start/optional_data_members.html index 646746a6..32684053 100644 --- a/doc/html/boost_optional/quick_start/optional_data_members.html +++ b/doc/html/boost_optional/quick_start/optional_data_members.html @@ -80,7 +80,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/quick_start/storage_in_containers.html b/doc/html/boost_optional/quick_start/storage_in_containers.html index 77f70143..95809140 100644 --- a/doc/html/boost_optional/quick_start/storage_in_containers.html +++ b/doc/html/boost_optional/quick_start/storage_in_containers.html @@ -50,7 +50,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html index e2a7d6d1..f5b40337 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html +++ b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html @@ -49,7 +49,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html index 451b14e2..eea25e98 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html +++ b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html @@ -46,7 +46,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_hpp_.html index 52af3272..8390a062 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_hpp_.html +++ b/doc/html/boost_optional/reference/header__boost_optional_hpp_.html @@ -33,7 +33,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html index e7ed5e1e..45d55b27 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html @@ -52,7 +52,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html index b7ff68f7..2781080e 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html @@ -507,7 +507,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html index 12a865e5..cbc3d647 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html @@ -538,7 +538,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html index 712e3871..b6e02272 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html @@ -1774,7 +1774,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html index 01a05e7e..50841642 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html @@ -47,7 +47,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html index 7da08d96..34729158 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html @@ -104,7 +104,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html index 2d188679..80d648a6 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html @@ -139,7 +139,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/io_header.html b/doc/html/boost_optional/reference/io_header.html index 6c9dcdca..9b33523a 100644 --- a/doc/html/boost_optional/reference/io_header.html +++ b/doc/html/boost_optional/reference/io_header.html @@ -58,7 +58,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/reference/io_header/io_semantics.html b/doc/html/boost_optional/reference/io_header/io_semantics.html index 15b199f6..f74ff4ac 100644 --- a/doc/html/boost_optional/reference/io_header/io_semantics.html +++ b/doc/html/boost_optional/reference/io_header/io_semantics.html @@ -98,7 +98,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/relnotes.html b/doc/html/boost_optional/relnotes.html index 560e7283..a7513ef9 100644 --- a/doc/html/boost_optional/relnotes.html +++ b/doc/html/boost_optional/relnotes.html @@ -28,6 +28,15 @@

      + Boost + Release 1.79 +

      +
      +

      + Boost Release 1.77

      @@ -36,7 +45,7 @@

      #92.

      - + Boost Release 1.76

      @@ -44,7 +53,7 @@

      Fixed MSVC warning C4702.

      - + Boost Release 1.75

      @@ -58,7 +67,7 @@

      - + Boost Release 1.73

      @@ -81,7 +90,7 @@

      - + Boost Release 1.69

      @@ -99,7 +108,7 @@

      - + Boost Release 1.68

      @@ -116,7 +125,7 @@

      - + Boost Release 1.67

      @@ -130,7 +139,7 @@

      - + Boost Release 1.66

      @@ -148,7 +157,7 @@

      - + Boost Release 1.63

      @@ -172,7 +181,7 @@

      - + Boost Release 1.62

      @@ -180,7 +189,7 @@

      Fixed Trac #12179.

      - + Boost Release 1.61

      @@ -223,7 +232,7 @@

      - + Boost Release 1.60

      @@ -234,7 +243,7 @@

      #11203.

      - + Boost Release 1.59

      @@ -248,7 +257,7 @@

      - + Boost Release 1.58

      @@ -284,7 +293,7 @@

      - + Boost Release 1.57

      @@ -294,7 +303,7 @@

      to fix C++03 compile error on logic_error("...")".

      - + Boost Release 1.56

      @@ -351,7 +360,7 @@

      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/design_overview.html b/doc/html/boost_optional/tutorial/design_overview.html index d088659f..c467658c 100644 --- a/doc/html/boost_optional/tutorial/design_overview.html +++ b/doc/html/boost_optional/tutorial/design_overview.html @@ -170,7 +170,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/design_overview/the_interface.html b/doc/html/boost_optional/tutorial/design_overview/the_interface.html index 2b25c711..f0bbc860 100644 --- a/doc/html/boost_optional/tutorial/design_overview/the_interface.html +++ b/doc/html/boost_optional/tutorial/design_overview/the_interface.html @@ -173,7 +173,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/design_overview/the_semantics.html b/doc/html/boost_optional/tutorial/design_overview/the_semantics.html index 16436a50..58e52267 100644 --- a/doc/html/boost_optional/tutorial/design_overview/the_semantics.html +++ b/doc/html/boost_optional/tutorial/design_overview/the_semantics.html @@ -107,7 +107,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/exception_safety_guarantees.html b/doc/html/boost_optional/tutorial/exception_safety_guarantees.html index 4d6ffd21..cca3e8cd 100644 --- a/doc/html/boost_optional/tutorial/exception_safety_guarantees.html +++ b/doc/html/boost_optional/tutorial/exception_safety_guarantees.html @@ -161,7 +161,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas.html b/doc/html/boost_optional/tutorial/gotchas.html index a01b3d1d..9382442d 100644 --- a/doc/html/boost_optional/tutorial/gotchas.html +++ b/doc/html/boost_optional/tutorial/gotchas.html @@ -98,7 +98,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html b/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html index 4055b916..0a719296 100644 --- a/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html +++ b/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html @@ -63,7 +63,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html b/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html index 082c6c6b..8771851b 100644 --- a/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html +++ b/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html @@ -45,7 +45,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html b/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html index 95499944..5c4b1cf2 100644 --- a/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html +++ b/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html @@ -49,7 +49,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/in_place_factories.html b/doc/html/boost_optional/tutorial/in_place_factories.html index 37c76cdc..10e62baa 100644 --- a/doc/html/boost_optional/tutorial/in_place_factories.html +++ b/doc/html/boost_optional/tutorial/in_place_factories.html @@ -183,7 +183,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/io_operators.html b/doc/html/boost_optional/tutorial/io_operators.html index 2afb07d7..d6d9dcbd 100644 --- a/doc/html/boost_optional/tutorial/io_operators.html +++ b/doc/html/boost_optional/tutorial/io_operators.html @@ -73,7 +73,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/optional_references.html b/doc/html/boost_optional/tutorial/optional_references.html index 8c9e2168..595303ee 100644 --- a/doc/html/boost_optional/tutorial/optional_references.html +++ b/doc/html/boost_optional/tutorial/optional_references.html @@ -103,7 +103,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html b/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html index 4581faee..112eb5da 100644 --- a/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html +++ b/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html @@ -133,7 +133,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/performance_considerations.html b/doc/html/boost_optional/tutorial/performance_considerations.html index f486628b..975a7388 100644 --- a/doc/html/boost_optional/tutorial/performance_considerations.html +++ b/doc/html/boost_optional/tutorial/performance_considerations.html @@ -251,7 +251,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/relational_operators.html b/doc/html/boost_optional/tutorial/relational_operators.html index f618bc74..ddb68707 100644 --- a/doc/html/boost_optional/tutorial/relational_operators.html +++ b/doc/html/boost_optional/tutorial/relational_operators.html @@ -99,7 +99,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/type_requirements.html b/doc/html/boost_optional/tutorial/type_requirements.html index 172e1894..9eac69df 100644 --- a/doc/html/boost_optional/tutorial/type_requirements.html +++ b/doc/html/boost_optional/tutorial/type_requirements.html @@ -95,7 +95,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/boost_optional/tutorial/when_to_use_optional.html b/doc/html/boost_optional/tutorial/when_to_use_optional.html index 66e18051..7fa6810e 100644 --- a/doc/html/boost_optional/tutorial/when_to_use_optional.html +++ b/doc/html/boost_optional/tutorial/when_to_use_optional.html @@ -128,7 +128,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/index.html b/doc/html/index.html index 98420b8f..08105c5b 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -26,7 +26,7 @@ Fernando Luis Cacciola Carballal

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal

      -

      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying @@ -145,7 +145,7 @@

      - +

      Last revised: May 19, 2021 at 21:27:41 GMT

      Last revised: November 20, 2021 at 00:57:52 GMT
      diff --git a/doc/html/optional/reference.html b/doc/html/optional/reference.html index 8ab0bfeb..1cbeafab 100644 --- a/doc/html/optional/reference.html +++ b/doc/html/optional/reference.html @@ -75,7 +75,7 @@ -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/optional/reference/header__boost_optional_optional_hpp_.html b/doc/html/optional/reference/header__boost_optional_optional_hpp_.html index 7d3e3456..c905bfce 100644 --- a/doc/html/optional/reference/header__boost_optional_optional_hpp_.html +++ b/doc/html/optional/reference/header__boost_optional_optional_hpp_.html @@ -97,7 +97,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/doc/html/optional/tutorial.html b/doc/html/optional/tutorial.html index 57e3c089..1331750c 100644 --- a/doc/html/optional/tutorial.html +++ b/doc/html/optional/tutorial.html @@ -139,7 +139,7 @@
      -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2020 Andrzej Krzemieński

      +

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

      diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 1c30327e..bb7e525e 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -1,5 +1,5 @@ // Copyright (C) 2003, 2008 Fernando Luis Cacciola Carballal. -// Copyright (C) 2014 - 2018 Andrzej Krzemienski. +// Copyright (C) 2014 - 2021 Andrzej Krzemienski. // // Use, modification, and distribution is subject to the Boost Software // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at @@ -37,14 +37,18 @@ #include #include #include +#include +#include #include #include #include #include #include +#include #include #include #include +#include #include #include #include @@ -781,7 +785,7 @@ class optional_base : public optional_tag // definition of metafunction is_optional_val_init_candidate template -struct is_optional_related +struct is_optional_or_tag : boost::conditional< boost::is_base_of::type>::value || boost::is_same::type, none_t>::value || boost::is_same::type, in_place_init_t>::value @@ -789,14 +793,22 @@ struct is_optional_related boost::true_type, boost::false_type>::type {}; +template +struct has_dedicated_constructor + : boost::disjunction, boost::is_same::type> > +{}; + +template +struct is_in_place_factory + : boost::disjunction< boost::is_base_of::type>, + boost::is_base_of::type> > +{}; + #if !defined(BOOST_OPTIONAL_DETAIL_NO_IS_CONSTRUCTIBLE_TRAIT) template -struct is_convertible_to_T_or_factory - : boost::conditional< boost::is_base_of::type>::value - || boost::is_base_of::type>::value - || (boost::is_constructible::value && !boost::is_same::type>::value) - , boost::true_type, boost::false_type>::type +struct is_factory_or_constructible_to_T + : boost::disjunction< is_in_place_factory, boost::is_constructible > {}; template @@ -806,7 +818,7 @@ struct is_optional_constructible : boost::is_constructible #else template -struct is_convertible_to_T_or_factory : boost::true_type +struct is_factory_or_constructible_to_T : boost::true_type {}; template @@ -815,15 +827,58 @@ struct is_optional_constructible : boost::true_type #endif // is_convertible condition -template ::value> +#if !defined(BOOST_NO_CXX11_DECLTYPE) && !BOOST_WORKAROUND(BOOST_MSVC, < 1800) +// for is_assignable + +#if (!defined BOOST_NO_CXX11_RVALUE_REFERENCES) +// On some initial rvalue reference implementations GCC does it in a strange way, +// preferring perfect-forwarding constructor to implicit copy constructor. + +template +struct is_opt_assignable + : boost::conjunction, boost::is_assignable > +{}; + +#else + +template +struct is_opt_assignable + : boost::conjunction, boost::is_assignable > +{}; + +#endif + +#else + +template +struct is_opt_assignable : boost::is_convertible +{}; + +#endif + +template +struct is_factory_or_opt_assignable_to_T + : boost::disjunction< is_in_place_factory, is_opt_assignable > +{}; + +template ::value> struct is_optional_val_init_candidate : boost::false_type {}; template struct is_optional_val_init_candidate - : boost::conditional< is_convertible_to_T_or_factory::value - , boost::true_type, boost::false_type>::type + : is_factory_or_constructible_to_T +{}; + +template ::value> +struct is_optional_val_assign_candidate + : boost::false_type +{}; + +template +struct is_optional_val_assign_candidate + : is_factory_or_opt_assignable_to_T {}; } // namespace optional_detail @@ -996,7 +1051,7 @@ class optional #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES template - BOOST_DEDUCED_TYPENAME boost::enable_if, optional&>::type + BOOST_DEDUCED_TYPENAME boost::enable_if, optional&>::type operator= ( Expr&& expr ) { this->assign_expr(boost::forward(expr),boost::addressof(expr)); diff --git a/test/Jamfile.v2 b/test/Jamfile.v2 index a881d52a..477f4df9 100644 --- a/test/Jamfile.v2 +++ b/test/Jamfile.v2 @@ -22,6 +22,7 @@ import testing ; [ run optional_test_swap.cpp ] [ run optional_test_conversions_from_U.cpp ] [ run optional_test_convert_from_T.cpp ] + [ run optional_test_convert_assign.cpp ] [ run optional_test_empty_braces.cpp ] [ run optional_test_make_optional.cpp ] [ run optional_test_flat_map.cpp ] diff --git a/test/optional_test_convert_assign.cpp b/test/optional_test_convert_assign.cpp new file mode 100644 index 00000000..2caaa188 --- /dev/null +++ b/test/optional_test_convert_assign.cpp @@ -0,0 +1,57 @@ +// Copyright (C) 2021 Andrzej Krzemienski. +// +// Use, modification, and distribution is subject to the Boost Software +// License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at +// http://www.boost.org/LICENSE_1_0.txt) +// +// See http://www.boost.org/lib/optional for documentation. +// +// You are welcome to contact the author at: +// akrzemi1@gmail.com + +#include "boost/optional/optional.hpp" + +#include "boost/core/lightweight_test.hpp" +#include "boost/none.hpp" + +//#ifndef BOOST_OPTIONAL_NO_CONVERTING_COPY_CTOR + +using boost::optional; + +struct implicit_bool_conv +{ + operator bool() { return true; } +}; + +struct explicit_bool_conv +{ + bool operator!() const BOOST_NOEXCEPT { return false; } + BOOST_EXPLICIT_OPERATOR_BOOL_NOEXCEPT() +}; + +template +void test_convert_assign() +{ + optional oi; + oi = From{}; + BOOST_TEST(oi); +} + +void test_no_bad_assignment() +{ +#if !defined(BOOST_NO_CXX11_DECLTYPE) && !BOOST_WORKAROUND(BOOST_MSVC, < 1800) + // this means that type trait `boost::is_assignable` works. + BOOST_STATIC_ASSERT((boost::is_assignable&, bool>::value)); + BOOST_STATIC_ASSERT((boost::is_assignable&, implicit_bool_conv>::value)); + BOOST_STATIC_ASSERT((! boost::is_assignable&, explicit_bool_conv>::value)); +#endif +} + +int main() +{ + test_convert_assign(); + test_convert_assign(); + test_no_bad_assignment(); + + return boost::report_errors(); +} From 56568445b94b496d22d3791b6770367c319a2da9 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 9 Dec 2021 22:22:05 +0100 Subject: [PATCH 027/163] Fix tests on C++03 --- test/optional_test_convert_assign.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/test/optional_test_convert_assign.cpp b/test/optional_test_convert_assign.cpp index 2caaa188..518421cd 100644 --- a/test/optional_test_convert_assign.cpp +++ b/test/optional_test_convert_assign.cpp @@ -33,7 +33,7 @@ template void test_convert_assign() { optional oi; - oi = From{}; + oi = From(); BOOST_TEST(oi); } From 8e86559103029319282be6503b11574e24ddf327 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andrzej=20Krzemie=C5=84ski?= Date: Wed, 22 Dec 2021 10:36:40 +0100 Subject: [PATCH 028/163] Fix convert-assign tests for C++98 --- test/optional_test_convert_assign.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/test/optional_test_convert_assign.cpp b/test/optional_test_convert_assign.cpp index 518421cd..f0366dcf 100644 --- a/test/optional_test_convert_assign.cpp +++ b/test/optional_test_convert_assign.cpp @@ -20,7 +20,7 @@ using boost::optional; struct implicit_bool_conv { - operator bool() { return true; } + operator bool() const { return false; } }; struct explicit_bool_conv From ec96129e9ea433af10bbe09495bdd2487869d71c Mon Sep 17 00:00:00 2001 From: Peter Dimov Date: Fri, 18 Feb 2022 21:55:13 +0200 Subject: [PATCH 029/163] Change aligned_storage::dummy::data to unsigned char[] --- include/boost/optional/detail/optional_aligned_storage.hpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/include/boost/optional/detail/optional_aligned_storage.hpp b/include/boost/optional/detail/optional_aligned_storage.hpp index 2937349f..b290921d 100644 --- a/include/boost/optional/detail/optional_aligned_storage.hpp +++ b/include/boost/optional/detail/optional_aligned_storage.hpp @@ -28,7 +28,7 @@ class aligned_storage // BOOST_MAY_ALIAS works around GCC warnings about breaking strict aliasing rules when casting storage address to T* union BOOST_MAY_ALIAS dummy_u { - char data[ sizeof(T) ]; + unsigned char data[ sizeof(T) ]; BOOST_DEDUCED_TYPENAME type_with_alignment< ::boost::alignment_of::value >::type aligner_; } dummy_ ; From 51b7053abfe07654864fa5b38074d07681abcce3 Mon Sep 17 00:00:00 2001 From: Peter Dimov Date: Fri, 18 Feb 2022 22:03:05 +0200 Subject: [PATCH 030/163] Construct the unqualified value_type with placement new --- include/boost/optional/optional.hpp | 25 +++++++++++++------------ 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index bb7e525e..a04ac861 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -129,6 +129,7 @@ class optional_base : public optional_tag protected : typedef T value_type ; + typedef typename boost::remove_const::type unqualified_value_type; protected: typedef T & reference_type ; @@ -405,14 +406,14 @@ class optional_base : public optional_tag void construct ( argument_type val ) { - ::new (m_storage.address()) value_type(val) ; + ::new (m_storage.address()) unqualified_value_type(val) ; m_initialized = true ; } #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES void construct ( rval_reference_type val ) { - ::new (m_storage.address()) value_type( boost::move(val) ) ; + ::new (m_storage.address()) unqualified_value_type( boost::move(val) ) ; m_initialized = true ; } #endif @@ -424,7 +425,7 @@ class optional_base : public optional_tag template void construct ( in_place_init_t, Args&&... args ) { - ::new (m_storage.address()) value_type( boost::forward(args)... ) ; + ::new (m_storage.address()) unqualified_value_type( boost::forward(args)... ) ; m_initialized = true ; } @@ -455,13 +456,13 @@ class optional_base : public optional_tag template void construct ( in_place_init_t, Arg&& arg ) { - ::new (m_storage.address()) value_type( boost::forward(arg) ); + ::new (m_storage.address()) unqualified_value_type( boost::forward(arg) ); m_initialized = true ; } void construct ( in_place_init_t ) { - ::new (m_storage.address()) value_type(); + ::new (m_storage.address()) unqualified_value_type(); m_initialized = true ; } @@ -515,20 +516,20 @@ class optional_base : public optional_tag template void construct ( in_place_init_t, const Arg& arg ) { - ::new (m_storage.address()) value_type( arg ); + ::new (m_storage.address()) unqualified_value_type( arg ); m_initialized = true ; } template void construct ( in_place_init_t, Arg& arg ) { - ::new (m_storage.address()) value_type( arg ); + ::new (m_storage.address()) unqualified_value_type( arg ); m_initialized = true ; } void construct ( in_place_init_t ) { - ::new (m_storage.address()) value_type(); + ::new (m_storage.address()) unqualified_value_type(); m_initialized = true ; } @@ -673,7 +674,7 @@ class optional_base : public optional_tag template void construct ( Expr&& expr, void const* ) { - new (m_storage.address()) value_type(boost::forward(expr)) ; + new (m_storage.address()) unqualified_value_type(boost::forward(expr)) ; m_initialized = true ; } @@ -694,7 +695,7 @@ class optional_base : public optional_tag template void construct ( Expr const& expr, void const* ) { - new (m_storage.address()) value_type(expr) ; + new (m_storage.address()) unqualified_value_type(expr) ; m_initialized = true ; } @@ -732,7 +733,7 @@ class optional_base : public optional_tag { // An exception can be thrown here. // It it happens, THIS will be left uninitialized. - new (m_storage.address()) value_type(boost::move(expr.get())) ; + new (m_storage.address()) unqualified_value_type(boost::move(expr.get())) ; m_initialized = true ; } } @@ -745,7 +746,7 @@ class optional_base : public optional_tag { // An exception can be thrown here. // It it happens, THIS will be left uninitialized. - new (m_storage.address()) value_type(expr.get()) ; + new (m_storage.address()) unqualified_value_type(expr.get()) ; m_initialized = true ; } } From 1e6f838a90a86be06a1e5a77e8410654971d6461 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Sat, 26 Feb 2022 14:15:28 +0100 Subject: [PATCH 031/163] added missing license info in one file --- .../optional_trivially_copyable_base.hpp | 57 +++++++++++-------- 1 file changed, 34 insertions(+), 23 deletions(-) diff --git a/include/boost/optional/detail/optional_trivially_copyable_base.hpp b/include/boost/optional/detail/optional_trivially_copyable_base.hpp index 2cabf9a7..5a5b80b6 100644 --- a/include/boost/optional/detail/optional_trivially_copyable_base.hpp +++ b/include/boost/optional/detail/optional_trivially_copyable_base.hpp @@ -1,3 +1,14 @@ +// Copyright (C) 2017 Andrzej Krzemienski. +// +// Use, modification, and distribution is subject to the Boost Software +// License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at +// http://www.boost.org/LICENSE_1_0.txt) +// +// See http://www.boost.org/libs/optional for documentation. +// +// You are welcome to contact the author at: +// akrzemi1@gmail.com + // trivilally-copyable version of the storage template @@ -69,7 +80,7 @@ class tc_optional_base : public optional_tag // ~tc_optional_base() = default; // Assigns from another optional (deep-copies the rhs value) - void assign ( tc_optional_base const& rhs ) + void assign ( tc_optional_base const& rhs ) { *this = rhs; } @@ -84,7 +95,7 @@ class tc_optional_base : public optional_tag #else m_storage = static_cast(rhs.get()); #endif - + m_initialized = rhs.is_initialized(); } @@ -99,7 +110,7 @@ class tc_optional_base : public optional_tag m_initialized = rhs.is_initialized(); } #endif - + void assign ( argument_type val ) { construct(val); @@ -166,7 +177,7 @@ class tc_optional_base : public optional_tag { construct(in_place_init, boost::forward(args)...); } - + template explicit tc_optional_base ( in_place_init_t, Args&&... args ) : @@ -174,7 +185,7 @@ class tc_optional_base : public optional_tag { construct(in_place_init, boost::forward(args)...); } - + template explicit tc_optional_base ( in_place_init_if_t, bool cond, Args&&... args ) : @@ -190,24 +201,24 @@ class tc_optional_base : public optional_tag m_storage = value_type( boost::forward(arg) ); m_initialized = true ; } - + void construct ( in_place_init_t ) { m_storage = value_type(); m_initialized = true ; } - + template void emplace_assign ( Arg&& arg ) { construct(in_place_init, boost::forward(arg)) ; } - + void emplace_assign () { construct(in_place_init) ; } - + template explicit tc_optional_base ( in_place_init_t, Arg&& arg ) : @@ -215,11 +226,11 @@ class tc_optional_base : public optional_tag { construct(in_place_init, boost::forward(arg)); } - + explicit tc_optional_base ( in_place_init_t ) : m_initialized(false), m_storage() {} - + template explicit tc_optional_base ( in_place_init_if_t, bool cond, Arg&& arg ) : @@ -228,7 +239,7 @@ class tc_optional_base : public optional_tag if ( cond ) construct(in_place_init, boost::forward(arg)); } - + explicit tc_optional_base ( in_place_init_if_t, bool cond ) : m_initialized(false) @@ -238,21 +249,21 @@ class tc_optional_base : public optional_tag } #else - + template void construct ( in_place_init_t, const Arg& arg ) { m_storage = value_type( arg ); m_initialized = true ; } - + template void construct ( in_place_init_t, Arg& arg ) { m_storage = value_type( arg ); m_initialized = true ; } - + void construct ( in_place_init_t ) { m_storage = value_type(); @@ -264,18 +275,18 @@ class tc_optional_base : public optional_tag { construct(in_place_init, arg); } - + template void emplace_assign ( Arg& arg ) { construct(in_place_init, arg); } - + void emplace_assign () { construct(in_place_init); } - + template explicit tc_optional_base ( in_place_init_t, const Arg& arg ) : m_initialized(false) @@ -289,13 +300,13 @@ class tc_optional_base : public optional_tag { construct(in_place_init, arg); } - + explicit tc_optional_base ( in_place_init_t ) : m_initialized(false) { construct(in_place_init); } - + template explicit tc_optional_base ( in_place_init_if_t, bool cond, const Arg& arg ) : m_initialized(false) @@ -303,15 +314,15 @@ class tc_optional_base : public optional_tag if ( cond ) construct(in_place_init, arg); } - + template explicit tc_optional_base ( in_place_init_if_t, bool cond, Arg& arg ) : m_initialized(false) { if ( cond ) construct(in_place_init, arg); - } - + } + explicit tc_optional_base ( in_place_init_if_t, bool cond ) : m_initialized(false) { From 916ca235722c7440d96e083f3655b80c176e1aed Mon Sep 17 00:00:00 2001 From: glywk Date: Mon, 7 Mar 2022 13:55:57 +0100 Subject: [PATCH 032/163] Update typography --- doc/17_gotchas.qbk | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/17_gotchas.qbk b/doc/17_gotchas.qbk index 5cfa36b7..5e5926e4 100644 --- a/doc/17_gotchas.qbk +++ b/doc/17_gotchas.qbk @@ -61,12 +61,12 @@ When an optional object that contains a value is moved from (is a source of move assert (opi); assert (*opi == nullptr); -Quite a lot of people expect that when an object that contains a value is moved from, its contained value should be destroyed. This is not so, for performance reasons. Current semantics allow the implementation of `boost::opiotnal` to be trivially copyable when `T` is trivial. +Quite a lot of people expect that when an object that contains a value is moved from, its contained value should be destroyed. This is not so, for performance reasons. Current semantics allow the implementation of `boost::optional` to be trivially copyable when `T` is trivial. [endsect] [section Mixed relational comparisons] -Because `T` is convertible to `optional` and because `opiotnal` is __SGI_LESS_THAN_COMPARABLE__ when `T` is __SGI_LESS_THAN_COMPARABLE__, +Because `T` is convertible to `optional` and because `optional` is __SGI_LESS_THAN_COMPARABLE__ when `T` is __SGI_LESS_THAN_COMPARABLE__, you can sometimes get an unexpected runtime result where you would rather expect a compiler error: optional Flight_plan::weight(); // sometimes no weight can be returned @@ -108,4 +108,4 @@ This is obviously redundant, but makes the warning disappear. [endsect] -[endsect] \ No newline at end of file +[endsect] From 4ead6d14ff889c9d80fc7e2b336daba2c0dcefbe Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Sat, 26 Mar 2022 23:52:09 +0100 Subject: [PATCH 033/163] Added release notes --- doc/91_relnotes.qbk | 6 +- doc/html/boost_optional/relnotes.html | 58 +++++++++++-------- .../gotchas/mixed_relational_comparisons.html | 2 +- .../gotchas/moved_from__optional_.html | 2 +- doc/html/index.html | 2 +- 5 files changed, 40 insertions(+), 30 deletions(-) diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index 48e59f54..f1f43640 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -14,10 +14,10 @@ [heading Boost Release 1.79] * Fixed [@https://github.com/boostorg/optional/issues/98 issue #98]. - -[heading Boost Release 1.77] - * Fixed [@https://github.com/boostorg/optional/issues/92 issue #92]. +* Added support for `BOOST_NO_IOSTREAM`. +* Now aligned storage uses `unsigned char` rather than `char` to avoid UB. +* Now using cv-unqualified `value_type` with placement `new` to avoid UB. [heading Boost Release 1.76] diff --git a/doc/html/boost_optional/relnotes.html b/doc/html/boost_optional/relnotes.html index fc6c8e90..f59b5e6a 100644 --- a/doc/html/boost_optional/relnotes.html +++ b/doc/html/boost_optional/relnotes.html @@ -31,21 +31,31 @@

      Boost Release 1.79

      -
      • +
        -

        - - Boost - Release 1.77 -

        -
        +
        • +
      • + Added support for BOOST_NO_IOSTREAM. +
        • +
      • + Now aligned storage uses unsigned + char rather than char + to avoid UB. +
        • +
      • + Now using cv-unqualified value_type + with placement new to avoid + UB. +
        • +

      - + Boost Release 1.76

      @@ -53,7 +63,7 @@

      Fixed MSVC warning C4702.

      - + Boost Release 1.75

      @@ -67,7 +77,7 @@

      - + Boost Release 1.73

      @@ -90,7 +100,7 @@

      - + Boost Release 1.69

      @@ -108,7 +118,7 @@

      - + Boost Release 1.68

      @@ -125,7 +135,7 @@

      - + Boost Release 1.67

      @@ -139,7 +149,7 @@

      - + Boost Release 1.66

      @@ -157,7 +167,7 @@

      - + Boost Release 1.63

      @@ -181,7 +191,7 @@

      - + Boost Release 1.62

      @@ -189,7 +199,7 @@

      Fixed Trac #12179.

      - + Boost Release 1.61

      @@ -232,7 +242,7 @@

      - + Boost Release 1.60

      @@ -243,7 +253,7 @@

      #11203.

      - + Boost Release 1.59

      @@ -257,7 +267,7 @@

      - + Boost Release 1.58

      @@ -293,7 +303,7 @@

      - + Boost Release 1.57

      @@ -303,7 +313,7 @@

      to fix C++03 compile error on logic_error("...")".

      - + Boost Release 1.56

      diff --git a/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html b/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html index 8771851b..c89f67d9 100644 --- a/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html +++ b/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html @@ -30,7 +30,7 @@

      Because T is convertible to optional<T> - and because opiotnal<T> + and because optional<T> is LessThanComparable when T is LessThanComparable, you can sometimes get an unexpected runtime result where you would rather expect a compiler error: diff --git a/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html b/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html index 5c4b1cf2..7924e618 100644 --- a/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html +++ b/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html @@ -42,7 +42,7 @@ Quite a lot of people expect that when an object that contains a value is moved from, its contained value should be destroyed. This is not so, for performance reasons. Current semantics allow the implementation of - boost::opiotnal<T> + boost::optional<T> to be trivially copyable when T is trivial.

      diff --git a/doc/html/index.html b/doc/html/index.html index 08105c5b..5b905c1f 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -145,7 +145,7 @@

      - +

      Last revised: November 20, 2021 at 00:57:52 GMT

      Last revised: March 26, 2022 at 22:47:53 GMT
      From 52abe4842e2650590ee1800b842701657d12b058 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Sat, 21 May 2022 01:13:10 +0200 Subject: [PATCH 034/163] Add std::hash specialization --- .../boost/optional/detail/optional_hash.hpp | 49 ++++++++++++++ include/boost/optional/optional.hpp | 1 + test/Jamfile.v2 | 1 + test/optional_test_hash.cpp | 64 +++++++++++++++++++ 4 files changed, 115 insertions(+) create mode 100644 include/boost/optional/detail/optional_hash.hpp create mode 100644 test/optional_test_hash.cpp diff --git a/include/boost/optional/detail/optional_hash.hpp b/include/boost/optional/detail/optional_hash.hpp new file mode 100644 index 00000000..fad5ce09 --- /dev/null +++ b/include/boost/optional/detail/optional_hash.hpp @@ -0,0 +1,49 @@ +// Copyright (C) 2022 Andrzej Krzemienski. +// +// Use, modification, and distribution is subject to the Boost Software +// License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at +// http://www.boost.org/LICENSE_1_0.txt) +// +// See http://www.boost.org/libs/optional for documentation. +// +// You are welcome to contact the author at: +// akrzemi1@gmail.com + +#ifndef BOOST_OPTIONAL_DETAIL_OPTIONAL_HASH_AJK_20MAY2022_HPP +#define BOOST_OPTIONAL_DETAIL_OPTIONAL_HASH_AJK_20MAY2022_HPP + +#include +#include + +#if !defined(BOOST_OPTIONAL_CONFIG_DO_NOT_SPECIALIZE_STD_HASH) && !defined(BOOST_NO_CXX11_HDR_FUNCTIONAL) + +#include + +namespace std +{ + template + struct hash > + { + typedef typename hash::result_type result_type; + typedef boost::optional argument_type; + + BOOST_CONSTEXPR result_type operator()(const argument_type& arg) const { + return arg ? std::hash()(*arg) : result_type(); + } + }; + + template + struct hash > + { + typedef typename hash::result_type result_type; + typedef boost::optional argument_type; + + BOOST_CONSTEXPR result_type operator()(const argument_type& arg) const { + return arg ? std::hash()(*arg) : result_type(); + } + }; +} + +#endif // !defined(BOOST_OPTIONAL_CONFIG_DO_NOT_SPECIALIZE_STD_HASH) && !defined(BOOST_NO_CXX11_HDR_FUNCTIONAL) + +#endif // header guard diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index a04ac861..4134a7e5 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -65,6 +65,7 @@ #include #include #include +#include namespace boost { namespace optional_detail { diff --git a/test/Jamfile.v2 b/test/Jamfile.v2 index 477f4df9..c9658637 100644 --- a/test/Jamfile.v2 +++ b/test/Jamfile.v2 @@ -26,6 +26,7 @@ import testing ; [ run optional_test_empty_braces.cpp ] [ run optional_test_make_optional.cpp ] [ run optional_test_flat_map.cpp ] + [ run optional_test_hash.cpp ] [ run optional_test_map.cpp ] [ run optional_test_tie.cpp ] [ run optional_test_ref_assign_portable_minimum.cpp ] diff --git a/test/optional_test_hash.cpp b/test/optional_test_hash.cpp new file mode 100644 index 00000000..8a631a25 --- /dev/null +++ b/test/optional_test_hash.cpp @@ -0,0 +1,64 @@ +// Copyright (C) 2014 Andrzej Krzemienski. +// +// Use, modification, and distribution is subject to the Boost Software +// License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at +// http://www.boost.org/LICENSE_1_0.txt) +// +// See http://www.boost.org/lib/optional for documentation. +// +// You are welcome to contact the author at: +// akrzemi1@gmail.com + +#include "boost/optional/optional.hpp" +#include "boost/config.hpp" +#include "boost/core/lightweight_test.hpp" + +#if !defined(BOOST_NO_CXX11_HDR_UNORDERED_SET) && !defined(BOOST_OPTIONAL_CONFIG_DO_NOT_SPECIALIZE_STD_HASH) + +#include + +void test_unordered_map() +{ + std::unordered_set > set; + set.insert(boost::optional(1)); + set.insert(boost::optional(1)); + + + BOOST_TEST(set.size() == 1u); + BOOST_TEST(set.find(boost::optional(1)) != set.end()); +} + +#else + +void test_unordered_map() +{} + +#endif + + +#if !defined(BOOST_OPTIONAL_CONFIG_DO_NOT_SPECIALIZE_STD_HASH) && !defined(BOOST_NO_CXX11_HDR_FUNCTIONAL) + +void tets_hash() +{ + std::hash > hash_int; + boost::optional oN; + boost::optional o1(1); + + BOOST_TEST(hash_int(oN) == hash_int(oN)); + BOOST_TEST(hash_int(o1) == hash_int(o1)); +} + +#else + +void tets_hash() +{} + +#endif + + +int main() +{ + test_unordered_map(); + tets_hash(); + return boost::report_errors(); +} From ec677383dc40aa78807ea734479cfd9d77c8dda7 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Mon, 23 May 2022 21:00:00 +0200 Subject: [PATCH 035/163] Added docs for std::hash But I do not know if they copile with QuickBook. --- doc/00_optional.qbk | 2 +- doc/27_ref_optional_synopsis.qbk | 10 +++++++++ doc/28_ref_optional_semantics.qbk | 34 +++++++++++++++++++++++++++++++ doc/91_relnotes.qbk | 6 +++++- 4 files changed, 50 insertions(+), 2 deletions(-) diff --git a/doc/00_optional.qbk b/doc/00_optional.qbk index e48c8e4d..5ff5981b 100644 --- a/doc/00_optional.qbk +++ b/doc/00_optional.qbk @@ -2,7 +2,7 @@ [quickbook 1.4] [authors [Cacciola Carballal, Fernando Luis]] [copyright 2003-2007 Fernando Luis Cacciola Carballal] - [copyright 2014-2021 Andrzej Krzemieński] + [copyright 2014-2022 Andrzej Krzemieński] [category miscellaneous] [id optional] [dirname optional] diff --git a/doc/27_ref_optional_synopsis.qbk b/doc/27_ref_optional_synopsis.qbk index bcd18e87..9af4d762 100644 --- a/doc/27_ref_optional_synopsis.qbk +++ b/doc/27_ref_optional_synopsis.qbk @@ -73,6 +73,16 @@ } // namespace boost + namespace std { + + template + struct hash > ; ``[link reference_std_hash_spec __GO_TO__]`` + + template + struct hash > ; ``[link reference_std_hash_spec __GO_TO__]`` + + } // namespace std + [endsect] diff --git a/doc/28_ref_optional_semantics.qbk b/doc/28_ref_optional_semantics.qbk index 2fa75008..d14e7d98 100644 --- a/doc/28_ref_optional_semantics.qbk +++ b/doc/28_ref_optional_semantics.qbk @@ -1408,3 +1408,37 @@ assert (addressof(*opt0) == addressof(y)); `` [endsect] + + +[section Detailed Semantics - std::hash Specializations] + +__SPACE__ +[#reference_std_hash_spec] + +`` +namespace std { + +template +struct hash > ; + +template +struct hash > ; + +} // namespace std +`` + +The specialization `hash>`` is enabled if and only if +`hash> is enabled. When enabled, for an object `o` +of type `optional``, if `o.has_­value() == true`, then `hash>()(o)` + evaluates to the same value as `hash>()(*o)``; otherwise it +evaluates to an unspecified value. +The member functions are not guaranteed to be `noexcept`. + +[caution +You may get compiler errors when your program provides specializations for +`std::hash>`. If this happens, define macro +`BOOST_OPTIONAL_CONFIG_DO_NOT_SPECIALIZE_STD_HASH` to suppress the specializations +of `std::hash` in this library. +] + +[endsect] diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index d61b289f..8db03b01 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -1,7 +1,7 @@ [/ Boost.Optional - Copyright (c) 2015 - 2021 Andrzej Krzemienski + Copyright (c) 2015 - 2022 Andrzej Krzemienski Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at @@ -11,6 +11,10 @@ [section:relnotes Release Notes] +[heading Boost Release 1.80] + +* Added specializations for `std::hash>`. This fixes [@https://github.com/boostorg/optional/issues/55 issue #55]. + [heading Boost Release 1.79] * Fixed [@https://github.com/boostorg/optional/issues/98 issue #98]. From a514ce627d99b9b1308b06a8e8c1fc08a0a7dbcd Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Mon, 23 May 2022 22:32:36 +0200 Subject: [PATCH 036/163] fix docs build --- doc/23_ref_optional_io.qbk | 18 +++++++++--------- doc/28_ref_optional_semantics.qbk | 2 +- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/doc/23_ref_optional_io.qbk b/doc/23_ref_optional_io.qbk index a9425d46..2f9b5a25 100644 --- a/doc/23_ref_optional_io.qbk +++ b/doc/23_ref_optional_io.qbk @@ -26,11 +26,11 @@ template template std::basic_ostream& operator<<(std::basic_ostream& out, none_t const&); ``[link reference_operator_ostream_none __GO_TO__]`` - + template std::basic_istream& operator>>(std::basic_istream& in, optional& v); ``[link reference_operator_istream __GO_TO__]`` - + } // namespace boost ``` @@ -43,8 +43,8 @@ template `template ` [br] -\u00A0\u00A0\u00A0\u00A0`std::basic_ostream&` [br] -\u00A0\u00A0\u00A0\u00A0`operator<<(std::basic_ostream& out, optional const& v);` + std::basic_ostream&` [br] + operator<<(std::basic_ostream& out, optional const& v);` * [*Effect:] Outputs an implementation-defined string. The output contains the information about whether the optional object contains a value or not. If `v` contains a value, the output contains result of calling `out << *v`. * [*Returns:] `out`. @@ -53,8 +53,8 @@ __SPACE__ [#reference_operator_ostream_none] `template ` [br] -\u00A0\u00A0\u00A0\u00A0`std::basic_ostream&` [br] -\u00A0\u00A0\u00A0\u00A0`operator<<(std::basic_ostream& out, none_t);` + std::basic_ostream&` [br] + operator<<(std::basic_ostream& out, none_t);` * [*Effect:] Outputs an implementation-defined string. * [*Returns:] `out`. @@ -63,11 +63,11 @@ __SPACE__ [#reference_operator_istream] `template ` [br] -\u00A0\u00A0\u00A0\u00A0`std::basic_ostream&` [br] -\u00A0\u00A0\u00A0\u00A0`operator>>(std::basic_istream& in, optional& v);` + std::basic_ostream&` [br] + operator>>(std::basic_istream& in, optional& v);` * [*Requires:] `T` is __SGI_DEFAULT_CONSTRUCTIBLE__ and __MOVE_CONSTRUCTIBLE__. -* [*Effect:] Reads the value of optional object from `in`. If the string representation indicates that the optional object should contain a value, `v` contains a value and its contained value is obtained as if by default-constructing an object `o` of type `T` and then calling `in >> o`; otherwise `v` does not contain a value, and the previously contained value (if any) has been destroyed. +* [*Effect:] Reads the value of optional object from `in`. If the string representation indicates that the optional object should contain a value, `v` contains a value and its contained value is obtained as if by default-constructing an object `o` of type `T` and then calling `in >> o`; otherwise `v` does not contain a value, and the previously contained value (if any) has been destroyed. * [*Returns:] `out`. [endsect] diff --git a/doc/28_ref_optional_semantics.qbk b/doc/28_ref_optional_semantics.qbk index d14e7d98..8e2159f5 100644 --- a/doc/28_ref_optional_semantics.qbk +++ b/doc/28_ref_optional_semantics.qbk @@ -1429,7 +1429,7 @@ struct hash > ; The specialization `hash>`` is enabled if and only if `hash> is enabled. When enabled, for an object `o` -of type `optional``, if `o.has_­value() == true`, then `hash>()(o)` +of type `optional`, if `o.has_­value() == true`, then `hash>()(o)` evaluates to the same value as `hash>()(*o)``; otherwise it evaluates to an unspecified value. The member functions are not guaranteed to be `noexcept`. From ce5834add255c44f74b21cea4a9f20850478472c Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Mon, 23 May 2022 22:42:04 +0200 Subject: [PATCH 037/163] further docs fixes --- doc/28_ref_optional_semantics.qbk | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/28_ref_optional_semantics.qbk b/doc/28_ref_optional_semantics.qbk index 8e2159f5..007d8f82 100644 --- a/doc/28_ref_optional_semantics.qbk +++ b/doc/28_ref_optional_semantics.qbk @@ -1427,10 +1427,10 @@ struct hash > ; } // namespace std `` -The specialization `hash>`` is enabled if and only if -`hash> is enabled. When enabled, for an object `o` +The specialization `hash>` is enabled if and only if +`hash>` is enabled. When enabled, for an object `o` of type `optional`, if `o.has_­value() == true`, then `hash>()(o)` - evaluates to the same value as `hash>()(*o)``; otherwise it + evaluates to the same value as `hash>()(*o)`; otherwise it evaluates to an unspecified value. The member functions are not guaranteed to be `noexcept`. From 85ebe0a2ed35e84d026a1f4be4e925085a1a90a7 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Sun, 19 Jun 2022 23:57:15 +0200 Subject: [PATCH 038/163] fix hash spec for C++17 --- include/boost/optional/detail/optional_hash.hpp | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/include/boost/optional/detail/optional_hash.hpp b/include/boost/optional/detail/optional_hash.hpp index fad5ce09..234ee7b6 100644 --- a/include/boost/optional/detail/optional_hash.hpp +++ b/include/boost/optional/detail/optional_hash.hpp @@ -24,7 +24,7 @@ namespace std template struct hash > { - typedef typename hash::result_type result_type; + typedef std::size_t result_type; typedef boost::optional argument_type; BOOST_CONSTEXPR result_type operator()(const argument_type& arg) const { @@ -35,7 +35,7 @@ namespace std template struct hash > { - typedef typename hash::result_type result_type; + typedef std::size_t result_type; typedef boost::optional argument_type; BOOST_CONSTEXPR result_type operator()(const argument_type& arg) const { From 938806c876c2a640413ec5b462a59c42d7c55cd7 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Wed, 22 Jun 2022 22:56:45 +0200 Subject: [PATCH 039/163] relnotes: info about breaking change --- doc/91_relnotes.qbk | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index 8db03b01..e63e2994 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -13,7 +13,7 @@ [heading Boost Release 1.80] -* Added specializations for `std::hash>`. This fixes [@https://github.com/boostorg/optional/issues/55 issue #55]. +* [*Breaking change:] Added specializations for `std::hash>`. This fixes [@https://github.com/boostorg/optional/issues/55 issue #55]. You may get compiler errors when your program provides specializations for `std::hash>`. If this happens, define macro `BOOST_OPTIONAL_CONFIG_DO_NOT_SPECIALIZE_STD_HASH` to suppress the specializations of `std::hash` in this library. [heading Boost Release 1.79] From 293d1861d7e4849dfed7dce25c41300f5eefec44 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Sat, 30 Jul 2022 10:09:35 +0200 Subject: [PATCH 040/163] fixed broken links to SGI docs --- doc/00_optional.qbk | 8 +++--- doc/01_quick_start.qbk | 44 ++++++++++++++++--------------- doc/12_when_to_use.qbk | 2 +- doc/13_relational_operators.qbk | 14 +++++----- doc/17_gotchas.qbk | 2 +- doc/19_type_requirements.qbk | 2 +- doc/23_ref_optional_io.qbk | 2 +- doc/28_ref_optional_semantics.qbk | 6 ++--- 8 files changed, 41 insertions(+), 39 deletions(-) diff --git a/doc/00_optional.qbk b/doc/00_optional.qbk index 5ff5981b..473212f3 100644 --- a/doc/00_optional.qbk +++ b/doc/00_optional.qbk @@ -38,10 +38,10 @@ Distributed under the Boost Software License, Version 1.0. [/ Other web resources ] [def __HASKELL__ [@http://www.haskell.org/ Haskell]] -[def __SGI_DEFAULT_CONSTRUCTIBLE__ [@http://www.sgi.com/tech/stl/DefaultConstructible.html `DefaultConstructible`]] -[def __SGI_LESS_THAN_COMPARABLE__ [@http://www.sgi.com/tech/stl/LessThanComparable.html `LessThanComparable`]] -[def __SGI_EQUALITY_COMPARABLE__ [@http://www.sgi.com/tech/stl/EqualityComparable.html `EqualityComparable`]] -[def __SGI_GENERATOR__ [@http://www.sgi.com/tech/stl/Generator.html `Generator`]] +[def __STD_DEFAULT_CONSTRUCTIBLE__ [@https://en.cppreference.com/w/cpp/named_req/DefaultConstructible `DefaultConstructible`]] +[def __STD_LESS_THAN_COMPARABLE__ [@https://en.cppreference.com/w/cpp/named_req/LessThanComparable `LessThanComparable`]] +[def __STD_EQUALITY_COMPARABLE__ [@https://en.cppreference.com/w/cpp/named_req/EqualityComparable `EqualityComparable`]] +[def __SGI_GENERATOR__ [@http://www.rrsd.com/software_development/stl/stl/Generator.html `Generator`]] [/ Icons ] diff --git a/doc/01_quick_start.qbk b/doc/01_quick_start.qbk index 6bfc3982..6341e614 100644 --- a/doc/01_quick_start.qbk +++ b/doc/01_quick_start.qbk @@ -25,7 +25,7 @@ All necessary functionality can be included with one header ` oi = convert(text); // move-construct if (oi) // contextual conversion to bool int i = *oi; // operator* - + In order to test if `optional` contains a value, we use the contextual conversion to type `bool`. Because of this we can combine the initialization of the optional object and the test into one instruction: if (boost::optional oi = convert(text)) @@ -34,7 +34,7 @@ In order to test if `optional` contains a value, we use the contextual conversio We extract the contained value with `operator*` (and with `operator->` where it makes sense). An attempt to extract the contained value of an uninitialized optional object is an ['undefined behaviour] (UB). This implementation guards the call with `BOOST_ASSERT`. Therefore you should be sure that the contained value is there before extracting. For instance, the following code is reasonably UB-safe: int i = *convert("100"); - + This is because we know that string value `"100"` converts to a valid value of `int`. If you do not like this potential UB, you can use an alternative way of extracting the contained value: try { @@ -47,15 +47,15 @@ This is because we know that string value `"100"` converts to a valid value of ` This version throws an exception upon an attempt to access a non-existent contained value. If your way of dealing with the missing value is to use some default, like `0`, there exists a yet another alternative: int k = convert(text).value_or(0); - + This uses the `atoi`-like approach to conversions: if `text` does not represent an integral number just return `0`. Finally, you can provide a callback to be called when trying to access the contained value fails: int fallback_to_default() { - cerr << "could not convert; using -1 instead" << endl; + cerr << "could not convert; using -1 instead" << endl; return -1; } - + int l = convert(text).value_or_eval(fallback_to_default); This will call the provided callback and return whatever the callback returns. The callback can have side effects: they will only be observed when the optional object does not contain a value. @@ -63,7 +63,7 @@ This will call the provided callback and return whatever the callback returns. T Now, let's consider how function `convert` can be implemented. boost::optional convert(const std::string& text) - { + { std::stringstream s(text); int i; if ((s >> i) && s.get() == std::char_traits::eof()) @@ -72,7 +72,7 @@ Now, let's consider how function `convert` can be implemented. return boost::none; } -Observe the two return statements. `return i` uses the converting constructor that can create `optional` from `T`. Thus constructed optional object is initialized and its value is a copy of `i`. The other return statement uses another converting constructor from a special tag `boost::none`. It is used to indicate that we want to create an uninitialized optional object. +Observe the two return statements. `return i` uses the converting constructor that can create `optional` from `T`. Thus constructed optional object is initialized and its value is a copy of `i`. The other return statement uses another converting constructor from a special tag `boost::none`. It is used to indicate that we want to create an uninitialized optional object. [endsect] @@ -91,7 +91,7 @@ We could write function `convert` in a slightly different manner, so that it has return ans; } -The default constructor of `optional` creates an unitialized optional object. Unlike with `int`s you cannot have an `optional` in an indeterminate state. Its state is always well defined. Instruction `ans = i` initializes the optional object. It uses the 'mixed' assignment from `int`. In general, for `optional`, when an assignment from `T` is invoked, it can do two things. If the optional object is not initialized (our case here), it initializes the contained value using `T`'s copy constructor. If the optional object is already initialized, it assigns the new value to it using `T`'s copy assignment. +The default constructor of `optional` creates an unitialized optional object. Unlike with `int`s you cannot have an `optional` in an indeterminate state. Its state is always well defined. Instruction `ans = i` initializes the optional object. It uses the 'mixed' assignment from `int`. In general, for `optional`, when an assignment from `T` is invoked, it can do two things. If the optional object is not initialized (our case here), it initializes the contained value using `T`'s copy constructor. If the optional object is already initialized, it assigns the new value to it using `T`'s copy assignment. [endsect] [section Optional data members] @@ -101,20 +101,20 @@ Suppose we want to implement a ['lazy load] optimization. This is because we do class Widget { mutable boost::optional resource_; - + public: Widget() {} - + const Resource& getResource() const // not thread-safe { if (resource_ == boost::none) resource_.emplace("resource", "arguments"); - + return *resource_; } }; - -`optional`'s default constructor creates an uninitialized optional. No call to `Resource`'s default constructor is attempted. `Resource` doesn't have to be __SGI_DEFAULT_CONSTRUCTIBLE__. In function `getResource` we first check if `resource_` is initialized. This time we do not use the contextual conversion to `bool`, but a comparison with `boost::none`. These two ways are equivalent. Function `emplace` initializes the optional in-place by perfect-forwarding the arguments to the constructor of `Resource`. No copy- or move-construction is involved here. `Resource` doesn't even have to be `MoveConstructible`. + +`optional`'s default constructor creates an uninitialized optional. No call to `Resource`'s default constructor is attempted. `Resource` doesn't have to be __STD_DEFAULT_CONSTRUCTIBLE__. In function `getResource` we first check if `resource_` is initialized. This time we do not use the contextual conversion to `bool`, but a comparison with `boost::none`. These two ways are equivalent. Function `emplace` initializes the optional in-place by perfect-forwarding the arguments to the constructor of `Resource`. No copy- or move-construction is involved here. `Resource` doesn't even have to be `MoveConstructible`. [note Function `emplace` is only available on compilers that support rvalue references and variadic templates. If your compiler does not support these features and you still need to avoid any move-constructions, use [link boost_optional.tutorial.in_place_factories In-Place Factories].] @@ -125,17 +125,17 @@ Suppose we want to implement a ['lazy load] optimization. This is because we do Suppose we have class `Date`, which does not have a default constructor: there is no good candidate for a default date. We have a function that returns two dates in form of a `boost::tuple`: boost::tuple getPeriod(); - + In other place we want to use the result of `getPeriod`, but want the two dates to be named: `begin` and `end`. We want to implement something like 'multiple return values': Date begin, end; // Error: no default ctor! boost::tie(begin, end) = getPeriod(); - + The second line works already, this is the capability of __BOOST_TUPLE__ library, but the first line won't work. We could set some invented initial dates, but it is confusing and may be an unacceptable cost, given that these values will be overwritten in the next line anyway. This is where `optional` can help: boost::optional begin, end; boost::tie(begin, end) = getPeriod(); - + It works because inside `boost::tie` a move-assignment from `T` is invoked on `optional`, which internally calls a move-constructor of `T`. [endsect] @@ -144,15 +144,17 @@ It works because inside `boost::tie` a move-assignment from `T` is invoked on `o Suppose you want to ask users to choose some number (an `int`). One of the valid responses is to choose nothing, which is represented by an uninitialized `optional`. You want to make a histogram showing how many times each choice was made. You can use an `std::map`: std::map, int> choices; - + for (int i = 0; i < LIMIT; ++i) { boost::optional choice = readChoice(); ++choices[choice]; } - -This works because `optional` is __SGI_LESS_THAN_COMPARABLE__ whenever `T` is __SGI_LESS_THAN_COMPARABLE__. In this case the state of being uninitialized is treated as a yet another value of `T`, which is compared less than any value of `T`. -[endsect] +This works because `optional` is __STD_LESS_THAN_COMPARABLE__ whenever `T` is __STD_LESS_THAN_COMPARABLE__. +In this case the state of being uninitialized is treated as a yet another value of `T`, +which is compared less than any value of `T`. +`optional` can also be stored as a key in `std::unordered_map` and `std::unordered_set` +as it provides specializations for `std::hash`. [endsect] - +[endsect] diff --git a/doc/12_when_to_use.qbk b/doc/12_when_to_use.qbk index 80dff54b..b1b44712 100644 --- a/doc/12_when_to_use.qbk +++ b/doc/12_when_to_use.qbk @@ -11,7 +11,7 @@ Here, having received an empty `vec` and having no `size_t` to return is not a [ Another typical situation is to indicate that we do not have a value yet, but we expect to have it later. This notion can be used in implementing solutions like lazy initialization or a two-phase initialization. -`optional` can be used to take a non-__SGI_DEFAULT_CONSTRUCTIBLE__ type `T` and create a sibling type with a default constructor. This is a way to add a ['null-state] to any type that doesn't have it already. +`optional` can be used to take a non-__STD_DEFAULT_CONSTRUCTIBLE__ type `T` and create a sibling type with a default constructor. This is a way to add a ['null-state] to any type that doesn't have it already. Sometimes type `T` already provides a built-in null-state, but it may still be useful to wrap it into `optional`. Consider `std::string`. When you read a piece of text from a GUI form or a DB table, it is hardly ever that the empty string indicates anything else but a missing text. And some data bases do not even distinguish between a null string entry and a non-null string of length 0. Still, it may be practical to use `optional` to indicate in the returned type that we want to treat the empty string in a special dedicated program path: diff --git a/doc/13_relational_operators.qbk b/doc/13_relational_operators.qbk index 861a4e86..fda77000 100644 --- a/doc/13_relational_operators.qbk +++ b/doc/13_relational_operators.qbk @@ -1,18 +1,18 @@  [section Relational operators] -Type `optional` is __SGI_EQUALITY_COMPARABLE__ whenever `T` is __SGI_EQUALITY_COMPARABLE__. Two optional objects containing a value compare in the same way as their contained values. The uninitialized state of `optional` is treated as a distinct value, equal to itself, and unequal to any value of type `T`: +Type `optional` is __STD_EQUALITY_COMPARABLE__ whenever `T` is __STD_EQUALITY_COMPARABLE__. Two optional objects containing a value compare in the same way as their contained values. The uninitialized state of `optional` is treated as a distinct value, equal to itself, and unequal to any value of type `T`: boost::optional oN = boost::none; boost::optional o0 = 0; boost::optional o1 = 1; - + assert(oN != o0); assert(o1 != oN); assert(o0 != o1); assert(oN == oN); assert(o0 == o0); - + The converting constructor from `T` as well as from `boost::none` implies the existence and semantics of the mixed comparison between `T` and `optional` as well as between `none_t` and `optionl`: assert(oN != 0); @@ -20,18 +20,18 @@ The converting constructor from `T` as well as from `boost::none` implies the ex assert(o0 != 1); assert(oN == boost::none); assert(o0 == 0); - + This mixed comparison has a practical interpretation, which is occasionally useful: boost::optional choice = ask_user(); if (choice == 2) start_procedure_2(); - + In the above example, the meaning of the comparison is 'user chose number 2'. If user chose nothing, he didn't choose number 2. -In case where `optional` is compared to `none`, it is not required that `T` be __SGI_EQUALITY_COMPARABLE__. +In case where `optional` is compared to `none`, it is not required that `T` be __STD_EQUALITY_COMPARABLE__. -In a similar manner, type `optional` is __SGI_LESS_THAN_COMPARABLE__ whenever `T` is __SGI_LESS_THAN_COMPARABLE__. The optional object containing no value is compared less than any value of `T`. To illustrate this, if the default ordering of `size_t` is {`0`, `1`, `2`, ...}, the default ordering of `optional` is {`boost::none`, `0`, `1`, `2`, ...}. This order does not have a practical interpretation. The goal is to have any semantically correct default ordering in order for `optional` to be usable in ordered associative containers (wherever `T` is usable). +In a similar manner, type `optional` is __STD_LESS_THAN_COMPARABLE__ whenever `T` is __STD_LESS_THAN_COMPARABLE__. The optional object containing no value is compared less than any value of `T`. To illustrate this, if the default ordering of `size_t` is {`0`, `1`, `2`, ...}, the default ordering of `optional` is {`boost::none`, `0`, `1`, `2`, ...}. This order does not have a practical interpretation. The goal is to have any semantically correct default ordering in order for `optional` to be usable in ordered associative containers (wherever `T` is usable). Mixed relational operators are the only case where the contained value of an optional object can be inspected without the usage of value accessing function (`operator*`, `value`, `value_or`). [endsect] diff --git a/doc/17_gotchas.qbk b/doc/17_gotchas.qbk index 5e5926e4..018ab6ac 100644 --- a/doc/17_gotchas.qbk +++ b/doc/17_gotchas.qbk @@ -66,7 +66,7 @@ Quite a lot of people expect that when an object that contains a value is moved [section Mixed relational comparisons] -Because `T` is convertible to `optional` and because `optional` is __SGI_LESS_THAN_COMPARABLE__ when `T` is __SGI_LESS_THAN_COMPARABLE__, +Because `T` is convertible to `optional` and because `optional` is __STD_LESS_THAN_COMPARABLE__ when `T` is __STD_LESS_THAN_COMPARABLE__, you can sometimes get an unexpected runtime result where you would rather expect a compiler error: optional Flight_plan::weight(); // sometimes no weight can be returned diff --git a/doc/19_type_requirements.qbk b/doc/19_type_requirements.qbk index 033a6eb3..989cc4ab 100644 --- a/doc/19_type_requirements.qbk +++ b/doc/19_type_requirements.qbk @@ -33,6 +33,6 @@ If `T` is `Moveable` (both __MOVE_CONSTRUCTIBLE__ and `MoveAssignable`) then `op Similarly, if `T` is `Copyable` (both __COPY_CONSTRUCTIBLE__ and `CopyAssignable`) then `optional` is also `Copyable` and additionally can be constructed and assigned from an lvalue of type `T`. -`T` ['is not] required to be __SGI_DEFAULT_CONSTRUCTIBLE__. +`T` ['is not] required to be __STD_DEFAULT_CONSTRUCTIBLE__. [endsect] diff --git a/doc/23_ref_optional_io.qbk b/doc/23_ref_optional_io.qbk index 2f9b5a25..22b25833 100644 --- a/doc/23_ref_optional_io.qbk +++ b/doc/23_ref_optional_io.qbk @@ -66,7 +66,7 @@ __SPACE__ std::basic_ostream&` [br] operator>>(std::basic_istream& in, optional& v);` -* [*Requires:] `T` is __SGI_DEFAULT_CONSTRUCTIBLE__ and __MOVE_CONSTRUCTIBLE__. +* [*Requires:] `T` is __STD_DEFAULT_CONSTRUCTIBLE__ and __MOVE_CONSTRUCTIBLE__. * [*Effect:] Reads the value of optional object from `in`. If the string representation indicates that the optional object should contain a value, `v` contains a value and its contained value is obtained as if by default-constructing an object `o` of type `T` and then calling `in >> o`; otherwise `v` does not contain a value, and the previously contained value (if any) has been destroyed. * [*Returns:] `out`. diff --git a/doc/28_ref_optional_semantics.qbk b/doc/28_ref_optional_semantics.qbk index 007d8f82..3ebf6d8e 100644 --- a/doc/28_ref_optional_semantics.qbk +++ b/doc/28_ref_optional_semantics.qbk @@ -1216,7 +1216,7 @@ __SPACE__ [: `bool operator == ( optional const& x, optional const& y );`] -* [*Requires:] `T` shall meet requirements of __SGI_EQUALITY_COMPARABLE__. +* [*Requires:] `T` shall meet requirements of __STD_EQUALITY_COMPARABLE__. * [*Returns:] If both `x` and `y` are initialized, `(*x == *y)`. If only `x` or `y` is initialized, `false`. If both are uninitialized, `true`. * [*Notes:] This definition guarantees that `optional` not containing a value is compared unequal to any `optional` containing any value, and equal to any other `optional` not containing a value. @@ -1249,7 +1249,7 @@ __SPACE__ * [*Returns:] `(!y) ? false : (!x) ? true : *x < *y`. * [*Notes:] This definition guarantees that `optional` not containing a value is ordered as less than any `optional` containing any value, and equivalent to any other `optional` not containing a value. Pointers have shallow relational operators while `optional` has deep relational operators. Do not use `operator<` directly in generic code -which expect to be given either an `optional` or a pointer; use __FUNCTION_LESS_POINTEES__ instead. `T` need not be __SGI_LESS_THAN_COMPARABLE__. Only single `operator<` is required. Other relational operations are defined in terms of this one. If `T`'s `operator<` satisfies the axioms of __SGI_LESS_THAN_COMPARABLE__ (transitivity, antisymmetry and irreflexivity), `optinal` is __SGI_LESS_THAN_COMPARABLE__. +which expect to be given either an `optional` or a pointer; use __FUNCTION_LESS_POINTEES__ instead. `T` need not be __STD_LESS_THAN_COMPARABLE__. Only single `operator<` is required. Other relational operations are defined in terms of this one. If `T`'s `operator<` satisfies the axioms of __STD_LESS_THAN_COMPARABLE__ (transitivity, antisymmetry and irreflexivity), `optinal` is __STD_LESS_THAN_COMPARABLE__. * [*Example:] `` optional oN, oN_; @@ -1310,7 +1310,7 @@ __SPACE__ [: `bool operator == ( none_t, optional const& x ) noexcept;`] * [*Returns:] `!x`. -* [*Notes:] `T` need not meet requirements of __SGI_EQUALITY_COMPARABLE__. +* [*Notes:] `T` need not meet requirements of __STD_EQUALITY_COMPARABLE__. __SPACE__ From 416c89e16569c236447856c58c5453f3610cc9fd Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Tue, 1 Nov 2022 21:46:22 -0400 Subject: [PATCH 041/163] spelling: achieve Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- doc/18_exception_safety.qbk | 2 +- doc/html/boost_optional/exception_safety_guarantees.html | 2 +- .../boost_optional/tutorial/exception_safety_guarantees.html | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/18_exception_safety.qbk b/doc/18_exception_safety.qbk index 331104b7..bb779a9b 100644 --- a/doc/18_exception_safety.qbk +++ b/doc/18_exception_safety.qbk @@ -51,7 +51,7 @@ Operation `emplace` provides basic exception safety guarantee. If it throws, the Unless `swap` on optional is customized, its primary implementation forwards calls to `T`'s `swap` or move constructor (depending on the initialization state of the optional objects). Thus, if both `T`'s `swap` and move constructor never throw, `swap` on `optional` never throws. similarly, if both `T`'s `swap` and move constructor offer strong guarantee, `swap` on `optional` also offers a strong guarantee. -In case `swap` on optional is customized, the call to `T`'s move constructor are replaced with the calls to `T`'s default constructor followed by `swap`. (This is more useful on older compilers that do not support move semantics, when one wants to acheive stronger exception safety guarantees.) In this case the exception safety guarantees for `swap` are reliant on the guarantees of `T`'s `swap` and default constructor +In case `swap` on optional is customized, the call to `T`'s move constructor are replaced with the calls to `T`'s default constructor followed by `swap`. (This is more useful on older compilers that do not support move semantics, when one wants to achieve stronger exception safety guarantees.) In this case the exception safety guarantees for `swap` are reliant on the guarantees of `T`'s `swap` and default constructor [endsect] diff --git a/doc/html/boost_optional/exception_safety_guarantees.html b/doc/html/boost_optional/exception_safety_guarantees.html index 25379180..3cb8b153 100644 --- a/doc/html/boost_optional/exception_safety_guarantees.html +++ b/doc/html/boost_optional/exception_safety_guarantees.html @@ -148,7 +148,7 @@

      move constructor are replaced with the calls to T's default constructor followed by swap. (This is more useful on older compilers that do not support move semantics, - when one wants to acheive stronger exception safety guarantees.) In this case + when one wants to achieve stronger exception safety guarantees.) In this case the exception safety guarantees for swap are reliant on the guarantees of T's swap and default constructor diff --git a/doc/html/boost_optional/tutorial/exception_safety_guarantees.html b/doc/html/boost_optional/tutorial/exception_safety_guarantees.html index cca3e8cd..90d817cc 100644 --- a/doc/html/boost_optional/tutorial/exception_safety_guarantees.html +++ b/doc/html/boost_optional/tutorial/exception_safety_guarantees.html @@ -153,7 +153,7 @@

      move constructor are replaced with the calls to T's default constructor followed by swap. (This is more useful on older compilers that do not support move semantics, - when one wants to acheive stronger exception safety guarantees.) In this + when one wants to achieve stronger exception safety guarantees.) In this case the exception safety guarantees for swap are reliant on the guarantees of T's swap and default constructor From ab7e5275c010259d6e69bdf60dcd1a6959ba4d95 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Tue, 1 Nov 2022 21:46:22 -0400 Subject: [PATCH 042/163] spelling: addresses Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- doc/90_dependencies.qbk | 2 +- .../emplace_operations_in_older_compilers.html | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/90_dependencies.qbk b/doc/90_dependencies.qbk index b5fa97c6..5fe76b52 100644 --- a/doc/90_dependencies.qbk +++ b/doc/90_dependencies.qbk @@ -60,7 +60,7 @@ On compilers that do not support rvalue references, each of these functions is s template void emplace(Arg& arg); void emplace(); -This workaround addressess about 40% of all use cases. If this is insufficient, you need to resort to using [link boost_optional.tutorial.in_place_factories In-Place Factories]. +This workaround addresses about 40% of all use cases. If this is insufficient, you need to resort to using [link boost_optional.tutorial.in_place_factories In-Place Factories]. [endsect] [section Optional Reference Binding][#optional_reference_binding] diff --git a/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html b/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html index 49cf74a6..7d6d4074 100644 --- a/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html +++ b/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html @@ -69,7 +69,7 @@ void emplace();

      - This workaround addressess about 40% of all use cases. If this is insufficient, + This workaround addresses about 40% of all use cases. If this is insufficient, you need to resort to using In-Place Factories.

      From 5ab4701192801ee34b47b6a408fda6a077e3ed29 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Tue, 1 Nov 2022 21:46:23 -0400 Subject: [PATCH 043/163] spelling: assignment Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- include/boost/optional/detail/optional_reference_spec.hpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/include/boost/optional/detail/optional_reference_spec.hpp b/include/boost/optional/detail/optional_reference_spec.hpp index 0dfeeefa..0069c79b 100644 --- a/include/boost/optional/detail/optional_reference_spec.hpp +++ b/include/boost/optional/detail/optional_reference_spec.hpp @@ -66,7 +66,7 @@ void prevent_assignment_from_false_const_integral() { #ifndef BOOST_OPTIONAL_CONFIG_ALLOW_BINDING_TO_RVALUES #ifdef BOOST_OPTIONAL_CONFIG_NO_PROPER_ASSIGN_FROM_CONST_INT - // MSVC compiler without rvalue refernces: we need to disable the asignment from + // MSVC compiler without rvalue refernces: we need to disable the assignment from // const integral lvalue reference, as it may be an invalid temporary BOOST_STATIC_ASSERT_MSG(!is_const_integral::value, "binding const lvalue references to integral types is disabled in this compiler"); From 9c44e402f691a61a1c6b6b3c8f20dc4c7974ab11 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Tue, 1 Nov 2022 21:46:23 -0400 Subject: [PATCH 044/163] spelling: because Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- include/boost/optional/detail/old_optional_implementation.hpp | 2 +- .../boost/optional/detail/optional_trivially_copyable_base.hpp | 2 +- include/boost/optional/optional.hpp | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/include/boost/optional/detail/old_optional_implementation.hpp b/include/boost/optional/detail/old_optional_implementation.hpp index 3431e155..c2085898 100644 --- a/include/boost/optional/detail/old_optional_implementation.hpp +++ b/include/boost/optional/detail/old_optional_implementation.hpp @@ -542,7 +542,7 @@ class optional_base : public optional_tag // Thus, the following overload is needed to properly handle the case when the 'lhs' // is another optional. // - // For VC<=70 compilers this workaround dosen't work becasue the comnpiler issues and error + // For VC<=70 compilers this workaround dosen't work because the comnpiler issues and error // instead of choosing the wrong overload // #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES diff --git a/include/boost/optional/detail/optional_trivially_copyable_base.hpp b/include/boost/optional/detail/optional_trivially_copyable_base.hpp index 5a5b80b6..7cf40976 100644 --- a/include/boost/optional/detail/optional_trivially_copyable_base.hpp +++ b/include/boost/optional/detail/optional_trivially_copyable_base.hpp @@ -455,7 +455,7 @@ class tc_optional_base : public optional_tag // Thus, the following overload is needed to properly handle the case when the 'lhs' // is another optional. // - // For VC<=70 compilers this workaround dosen't work becasue the comnpiler issues and error + // For VC<=70 compilers this workaround dosen't work because the comnpiler issues and error // instead of choosing the wrong overload // #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 4134a7e5..2c0ff52d 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -722,7 +722,7 @@ class optional_base : public optional_tag // Thus, the following overload is needed to properly handle the case when the 'lhs' // is another optional. // - // For VC<=70 compilers this workaround dosen't work becasue the comnpiler issues and error + // For VC<=70 compilers this workaround dosen't work because the comnpiler issues and error // instead of choosing the wrong overload // #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES From de27c0f8536b0587e2c64340ad80e7a19d24d526 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Tue, 1 Nov 2022 21:46:24 -0400 Subject: [PATCH 045/163] spelling: classes Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- doc/27_ref_optional_synopsis.qbk | 2 +- .../header_optional_in_place_init.html | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/27_ref_optional_synopsis.qbk b/doc/27_ref_optional_synopsis.qbk index 9af4d762..9be5846c 100644 --- a/doc/27_ref_optional_synopsis.qbk +++ b/doc/27_ref_optional_synopsis.qbk @@ -102,7 +102,7 @@ } -Classes `in_place_init_t` and `in_place_init_if_t` are empty clsses. Their purpose is to control overload resolution in the initialization of optional objects. +Classes `in_place_init_t` and `in_place_init_if_t` are empty classes. Their purpose is to control overload resolution in the initialization of optional objects. They are empty, trivially copyable classes with disabled default constructor. [endsect] diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html index 50841642..ca73fd90 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html @@ -40,7 +40,7 @@

      Classes in_place_init_t and in_place_init_if_t - are empty clsses. Their purpose is to control overload resolution in the + are empty classes. Their purpose is to control overload resolution in the initialization of optional objects. They are empty, trivially copyable classes with disabled default constructor.

      From c4291fa461cada7ba703ea757b9c9acecc5f117a Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Tue, 1 Nov 2022 21:46:24 -0400 Subject: [PATCH 046/163] spelling: compiler Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- include/boost/optional/detail/old_optional_implementation.hpp | 2 +- .../boost/optional/detail/optional_trivially_copyable_base.hpp | 2 +- include/boost/optional/optional.hpp | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/include/boost/optional/detail/old_optional_implementation.hpp b/include/boost/optional/detail/old_optional_implementation.hpp index c2085898..5aaeec1b 100644 --- a/include/boost/optional/detail/old_optional_implementation.hpp +++ b/include/boost/optional/detail/old_optional_implementation.hpp @@ -542,7 +542,7 @@ class optional_base : public optional_tag // Thus, the following overload is needed to properly handle the case when the 'lhs' // is another optional. // - // For VC<=70 compilers this workaround dosen't work because the comnpiler issues and error + // For VC<=70 compilers this workaround dosen't work because the compiler issues and error // instead of choosing the wrong overload // #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES diff --git a/include/boost/optional/detail/optional_trivially_copyable_base.hpp b/include/boost/optional/detail/optional_trivially_copyable_base.hpp index 7cf40976..4049918e 100644 --- a/include/boost/optional/detail/optional_trivially_copyable_base.hpp +++ b/include/boost/optional/detail/optional_trivially_copyable_base.hpp @@ -455,7 +455,7 @@ class tc_optional_base : public optional_tag // Thus, the following overload is needed to properly handle the case when the 'lhs' // is another optional. // - // For VC<=70 compilers this workaround dosen't work because the comnpiler issues and error + // For VC<=70 compilers this workaround dosen't work because the compiler issues and error // instead of choosing the wrong overload // #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 2c0ff52d..1d6b6d11 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -722,7 +722,7 @@ class optional_base : public optional_tag // Thus, the following overload is needed to properly handle the case when the 'lhs' // is another optional. // - // For VC<=70 compilers this workaround dosen't work because the comnpiler issues and error + // For VC<=70 compilers this workaround dosen't work because the compiler issues and error // instead of choosing the wrong overload // #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES From bcc83a662af738abff7c6062072a5cf092379729 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Tue, 1 Nov 2022 21:46:25 -0400 Subject: [PATCH 047/163] spelling: compiling Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- doc/17_gotchas.qbk | 2 +- .../gotchas/false_positive_with__wmaybe_uninitialized.html | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/17_gotchas.qbk b/doc/17_gotchas.qbk index 018ab6ac..8e894e9a 100644 --- a/doc/17_gotchas.qbk +++ b/doc/17_gotchas.qbk @@ -80,7 +80,7 @@ you can sometimes get an unexpected runtime result where you would rather expect [section False positive with -Wmaybe-uninitialized] -Sometimes on GCC compilers below version 5.1 you may get an -Wmaybe-uninitialized warning when copiling with option -02 on a perfectly valid `boost::optional` usage. For instance in this program: +Sometimes on GCC compilers below version 5.1 you may get an -Wmaybe-uninitialized warning when compiling with option -02 on a perfectly valid `boost::optional` usage. For instance in this program: #include diff --git a/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html b/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html index 0a719296..0228f2ea 100644 --- a/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html +++ b/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html @@ -29,7 +29,7 @@

      Sometimes on GCC compilers below version 5.1 you may get an -Wmaybe-uninitialized - warning when copiling with option -02 on a perfectly valid boost::optional usage. For instance in this + warning when compiling with option -02 on a perfectly valid boost::optional usage. For instance in this program: 

      #include <boost/optional.hpp>

From 29dd9187ec7863824176e27362c428c6911d6f44 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:25 -0400
Subject: [PATCH 048/163] spelling: convertibility

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 test/optional_test_ref_portable_minimum.cpp | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/test/optional_test_ref_portable_minimum.cpp b/test/optional_test_ref_portable_minimum.cpp
index ec5b827a..bf7af323 100644
--- a/test/optional_test_ref_portable_minimum.cpp
+++ b/test/optional_test_ref_portable_minimum.cpp
@@ -431,7 +431,7 @@ void test_swap()
 }
 
 template 
-void test_convertability_of_compatible_reference_types()
+void test_convertibility_of_compatible_reference_types()
 {
   typename concrete_type_of::type v1(1);
   optional oN, o1(v1);
@@ -489,11 +489,11 @@ int main()
   test_optional_const_ref();
   test_optional_const_ref< optional >();
   
-  test_convertability_of_compatible_reference_types();
-  test_convertability_of_compatible_reference_types();
-  test_convertability_of_compatible_reference_types();
-  test_convertability_of_compatible_reference_types();
-  test_convertability_of_compatible_reference_types, const optional >();
+  test_convertibility_of_compatible_reference_types();
+  test_convertibility_of_compatible_reference_types();
+  test_convertibility_of_compatible_reference_types();
+  test_convertibility_of_compatible_reference_types();
+  test_convertibility_of_compatible_reference_types, const optional >();
   
   return boost::report_errors();
 }

From 6f85014c003a69824c666211afd6c3ba0b6d2379 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:24 -0400
Subject: [PATCH 049/163] spelling: converting

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 test/optional_test_fail_const_swap.cpp              | 4 ++--
 test/optional_test_fail_convert_assign_of_enums.cpp | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/test/optional_test_fail_const_swap.cpp b/test/optional_test_fail_const_swap.cpp
index 3d97a1c4..b91582cf 100644
--- a/test/optional_test_fail_const_swap.cpp
+++ b/test/optional_test_fail_const_swap.cpp
@@ -13,7 +13,7 @@
 
 // THIS TEST SHOULD FAIL TO COMPILE
 
-void test_converitng_assignment_of_different_enums()
+void test_converting_assignment_of_different_enums()
 {
   const boost::optional o1(1);
   const boost::optional o2(2);
@@ -22,5 +22,5 @@ void test_converitng_assignment_of_different_enums()
 
 int main()
 {
-  test_converitng_assignment_of_different_enums();
+  test_converting_assignment_of_different_enums();
 }
diff --git a/test/optional_test_fail_convert_assign_of_enums.cpp b/test/optional_test_fail_convert_assign_of_enums.cpp
index 59538505..149df034 100644
--- a/test/optional_test_fail_convert_assign_of_enums.cpp
+++ b/test/optional_test_fail_convert_assign_of_enums.cpp
@@ -16,7 +16,7 @@
 enum E1 {e1};
 enum E2 {e2};
 
-void test_converitng_assignment_of_different_enums()
+void test_converting_assignment_of_different_enums()
 {
   boost::optional o2(e2);
   boost::optional o1;

From 74a684232f990db15c2f549523ce030fac71c04e Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:26 -0400
Subject: [PATCH 050/163] spelling: defined

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 test/optional_test_noexcept_move.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/test/optional_test_noexcept_move.cpp b/test/optional_test_noexcept_move.cpp
index 2e270ed5..258bacd2 100644
--- a/test/optional_test_noexcept_move.cpp
+++ b/test/optional_test_noexcept_move.cpp
@@ -105,7 +105,7 @@ void test_noexcept_optional_with_operator() // compile-time test
   BOOST_STATIC_ASSERT(!BOOST_NOEXCEPT_EXPR( onx0 = ONx0() ));
 }
 
-#endif // !defned BOOST_NO_CXX11_NOEXCEPT
+#endif // !defined BOOST_NO_CXX11_NOEXCEPT
 #endif // !defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES
 
 int main()

From cc416b8989fdceb248dab675da1d66fd07c55c26 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:26 -0400
Subject: [PATCH 051/163] spelling: deprecated

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 doc/28_ref_optional_semantics.qbk                           | 6 +++---
 .../detailed_semantics___optional_references.html           | 6 +++---
 .../boost/optional/detail/old_optional_implementation.hpp   | 2 +-
 .../optional/detail/optional_trivially_copyable_base.hpp    | 2 +-
 include/boost/optional/optional.hpp                         | 2 +-
 5 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/doc/28_ref_optional_semantics.qbk b/doc/28_ref_optional_semantics.qbk
index 3ebf6d8e..e55771b6 100644
--- a/doc/28_ref_optional_semantics.qbk
+++ b/doc/28_ref_optional_semantics.qbk
@@ -1136,21 +1136,21 @@ __SPACE__
 [#reference_optional_ref_reset_value]
 [: `template void optional::reset ( R&& r) noexcept;`]
 * [*Effects:] Equivalent to `*this = std::forward(r)`.
-* [*Remarks:] This function is depprecated.
+* [*Remarks:] This function is deprecated.
 
 __SPACE__
 
 [#reference_optional_ref_is_initialized]
 [: `bool optional::is_initialized() const noexcept;`]
 * [*Effects:] Equivalent to `return bool(*this)`.
-* [*Remarks:] This function is depprecated.
+* [*Remarks:] This function is deprecated.
 
 __SPACE__
 
 [#reference_optional_ref_get_value_or_value]
 [: `template T& optional::get_value_or( R&& r ) const noexcept;`]
 * [*Effects:] Equivalent to `return value_or(std::forward(r);`.
-* [*Remarks:] This function is depprecated.
+* [*Remarks:] This function is deprecated.
 
 [endsect]
 
diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html
index cbc3d647..42d7e20b 100644
--- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html
+++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html
@@ -502,7 +502,7 @@
               Effects: Equivalent to *this = std::forward<R>(r).
             
 
    • 
-              Remarks: This function is depprecated.
+              Remarks: This function is deprecated.
             
      • 
 
 
      
@@ -516,7 +516,7 @@
               Effects: Equivalent to return bool(*this).
             
 
    • 
-              Remarks: This function is depprecated.
+              Remarks: This function is deprecated.
             
      • 
 
 
      
@@ -532,7 +532,7 @@
               Effects: Equivalent to return value_or(std::forward<R>(r);.
             
 
    • 
-              Remarks: This function is depprecated.
+              Remarks: This function is deprecated.
             
      • 
 
 
diff --git a/include/boost/optional/detail/old_optional_implementation.hpp b/include/boost/optional/detail/old_optional_implementation.hpp
index 5aaeec1b..0128de47 100644
--- a/include/boost/optional/detail/old_optional_implementation.hpp
+++ b/include/boost/optional/detail/old_optional_implementation.hpp
@@ -336,7 +336,7 @@ class optional_base : public optional_tag
     // No-throw (assuming T::~T() doesn't)
     void reset() BOOST_NOEXCEPT { destroy(); }
 
-    // **DEPPRECATED** Replaces the current value -if any- with 'val'
+    // **DEPRECATED** Replaces the current value -if any- with 'val'
     void reset ( argument_type val ) { assign(val); }
 
     // Returns a pointer to the value if this is initialized, otherwise,
diff --git a/include/boost/optional/detail/optional_trivially_copyable_base.hpp b/include/boost/optional/detail/optional_trivially_copyable_base.hpp
index 4049918e..c1f80044 100644
--- a/include/boost/optional/detail/optional_trivially_copyable_base.hpp
+++ b/include/boost/optional/detail/optional_trivially_copyable_base.hpp
@@ -142,7 +142,7 @@ class tc_optional_base : public optional_tag
     // No-throw (assuming T::~T() doesn't)
     void reset() BOOST_NOEXCEPT { destroy(); }
 
-    // **DEPPRECATED** Replaces the current value -if any- with 'val'
+    // **DEPRECATED** Replaces the current value -if any- with 'val'
     void reset ( argument_type val ) BOOST_NOEXCEPT { assign(val); }
 
     // Returns a pointer to the value if this is initialized, otherwise,
diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp
index 1d6b6d11..d93f1715 100644
--- a/include/boost/optional/optional.hpp
+++ b/include/boost/optional/optional.hpp
@@ -392,7 +392,7 @@ class optional_base : public optional_tag
     // No-throw (assuming T::~T() doesn't)
     void reset() BOOST_NOEXCEPT { destroy(); }
 
-    // **DEPPRECATED** Replaces the current value -if any- with 'val'
+    // **DEPRECATED** Replaces the current value -if any- with 'val'
     void reset ( argument_type val ) { assign(val); }
 
     // Returns a pointer to the value if this is initialized, otherwise,

From 2121a9fa59b233a39fcd1c0029cc1b21fee356dc Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:27 -0400
Subject: [PATCH 052/163] spelling: different

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 doc/90_dependencies.qbk                                         | 2 +-
 .../optional_reference_binding.html                             | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/90_dependencies.qbk b/doc/90_dependencies.qbk
index 5fe76b52..8e3e8ded 100644
--- a/doc/90_dependencies.qbk
+++ b/doc/90_dependencies.qbk
@@ -65,7 +65,7 @@ This workaround addresses about 40% of all use cases. If this is insufficient, y
 
 [section Optional Reference Binding][#optional_reference_binding]
 
-A number of compilers incorrectly treat const lvalues of integral type as rvalues, and create an illegal temporary when binding to an lvalue reference to const in some expressions. This could result in creating an optional lvalue reference that is in fact bound to an unexpected temporary rather than to the intended object. In order to prevent hard to find run-time bugs, this library performs compile-time checks to prevent expressions that would otherwise bind an optional reference to an unexpected temporary. As a consequence, on certain compilers certain pieces of functionality in optional references are missing. In order to maintain a portability of your code across diferent compilers, it is recommended that you only stick to the minimum portable interface of optional references: prefer direct-initialization and copy assignment of optional references to copy-initialization and assignment from `T&`:
+A number of compilers incorrectly treat const lvalues of integral type as rvalues, and create an illegal temporary when binding to an lvalue reference to const in some expressions. This could result in creating an optional lvalue reference that is in fact bound to an unexpected temporary rather than to the intended object. In order to prevent hard to find run-time bugs, this library performs compile-time checks to prevent expressions that would otherwise bind an optional reference to an unexpected temporary. As a consequence, on certain compilers certain pieces of functionality in optional references are missing. In order to maintain a portability of your code across different compilers, it is recommended that you only stick to the minimum portable interface of optional references: prefer direct-initialization and copy assignment of optional references to copy-initialization and assignment from `T&`:
 
     const int i = 0;
     optional or1;
diff --git a/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html b/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html
index a25f2b0b..9bd61868 100644
--- a/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html
+++ b/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html
@@ -37,7 +37,7 @@
         prevent expressions that would otherwise bind an optional reference to an
         unexpected temporary. As a consequence, on certain compilers certain pieces
         of functionality in optional references are missing. In order to maintain
-        a portability of your code across diferent compilers, it is recommended that
+        a portability of your code across different compilers, it is recommended that
         you only stick to the minimum portable interface of optional references:
         prefer direct-initialization and copy assignment of optional references to
         copy-initialization and assignment from T&:

From 9944804c5c66740961b9c9ee2c99c8ad18a42c84 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:27 -0400
Subject: [PATCH 053/163] spelling: doesn't

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 include/boost/optional/detail/old_optional_implementation.hpp   | 2 +-
 .../boost/optional/detail/optional_trivially_copyable_base.hpp  | 2 +-
 include/boost/optional/optional.hpp                             | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/include/boost/optional/detail/old_optional_implementation.hpp b/include/boost/optional/detail/old_optional_implementation.hpp
index 0128de47..2b7da28e 100644
--- a/include/boost/optional/detail/old_optional_implementation.hpp
+++ b/include/boost/optional/detail/old_optional_implementation.hpp
@@ -542,7 +542,7 @@ class optional_base : public optional_tag
     //   Thus, the following overload is needed to properly handle the case when the 'lhs'
     //   is another optional.
     //
-    // For VC<=70 compilers this workaround dosen't work because the compiler issues and error
+    // For VC<=70 compilers this workaround doesn't work because the compiler issues and error
     // instead of choosing the wrong overload
     //
 #ifndef  BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES
diff --git a/include/boost/optional/detail/optional_trivially_copyable_base.hpp b/include/boost/optional/detail/optional_trivially_copyable_base.hpp
index c1f80044..e8eff70b 100644
--- a/include/boost/optional/detail/optional_trivially_copyable_base.hpp
+++ b/include/boost/optional/detail/optional_trivially_copyable_base.hpp
@@ -455,7 +455,7 @@ class tc_optional_base : public optional_tag
     //   Thus, the following overload is needed to properly handle the case when the 'lhs'
     //   is another optional.
     //
-    // For VC<=70 compilers this workaround dosen't work because the compiler issues and error
+    // For VC<=70 compilers this workaround doesn't work because the compiler issues and error
     // instead of choosing the wrong overload
     //
 #ifndef  BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES
diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp
index d93f1715..56d50d78 100644
--- a/include/boost/optional/optional.hpp
+++ b/include/boost/optional/optional.hpp
@@ -722,7 +722,7 @@ class optional_base : public optional_tag
     //   Thus, the following overload is needed to properly handle the case when the 'lhs'
     //   is another optional.
     //
-    // For VC<=70 compilers this workaround dosen't work because the compiler issues and error
+    // For VC<=70 compilers this workaround doesn't work because the compiler issues and error
     // instead of choosing the wrong overload
     //
 #ifndef  BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES

From 802e73477a99c9775ec45d54d68c6dece750b19c Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:28 -0400
Subject: [PATCH 054/163] spelling: flagged

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 test/optional_test.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/test/optional_test.cpp b/test/optional_test.cpp
index f5ca4369..5a61a20e 100644
--- a/test/optional_test.cpp
+++ b/test/optional_test.cpp
@@ -451,7 +451,7 @@ void test_throwing_val_assign_on_initialized( T const* )
     // This should:
     //   Attempt to assign 'a' and throw.
     //   opt is kept initialized but its value not neccesarily fully assigned
-    //   (in this test, incompletely assigned is flaged with the value -1 being set)
+    //   (in this test, incompletely assigned is flagged with the value -1 being set)
     set_pending_assign( ARG(T) ) ;
     opt.reset ( a ) ;
     passed = true ;
@@ -576,7 +576,7 @@ void test_throwing_assign_to_initialized( T const* )
     // This should:
     //   Attempt to copy construct 'opt1.value()' into opt0 and throw.
     //   opt0 is kept initialized but its value not neccesarily fully assigned
-    //   (in this test, incompletely assigned is flaged with the value -1 being set)
+    //   (in this test, incompletely assigned is flagged with the value -1 being set)
     set_pending_assign( ARG(T) ) ;
     opt0 = opt1 ;
     passed = true ;

From 56156dcc87afa9538d544563dc1cb5ffad2102ea Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:28 -0400
Subject: [PATCH 055/163] spelling: functions

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 include/boost/optional/detail/optional_config.hpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/include/boost/optional/detail/optional_config.hpp b/include/boost/optional/detail/optional_config.hpp
index 73f25054..09835cd8 100644
--- a/include/boost/optional/detail/optional_config.hpp
+++ b/include/boost/optional/detail/optional_config.hpp
@@ -116,7 +116,7 @@
 
 // Detect suport for defaulting move operations
 // (some older compilers implement rvalue references,
-// defaulted funcitons but move operations are not special members and cannot be defaulted)
+// defaulted functions but move operations are not special members and cannot be defaulted)
 
 #ifdef BOOST_NO_CXX11_DEFAULTED_FUNCTIONS
 # define BOOST_OPTIONAL_DETAIL_NO_DEFAULTED_MOVE_FUNCTIONS

From 969930959c76ec2c75f4d622c3dd8427f429ac37 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:28 -0400
Subject: [PATCH 056/163] spelling: implicitly

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 test/optional_test.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/test/optional_test.cpp b/test/optional_test.cpp
index 5a61a20e..db89c680 100644
--- a/test/optional_test.cpp
+++ b/test/optional_test.cpp
@@ -77,7 +77,7 @@ void test_basics( T const* )
   check_uninitialized(def);
 
   // Implicit construction
-  // The first parameter is implicitely converted to optional(a);
+  // The first parameter is implicitly converted to optional(a);
   test_implicit_construction(a,a,z);
 
   // Direct initialization.

From e26c2d7489d9669a7225c47add686b55af5c5889 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 22:01:03 -0400
Subject: [PATCH 057/163] spelling: intel

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 test/optional_test_fail3.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/test/optional_test_fail3.cpp b/test/optional_test_fail3.cpp
index 1ce685a4..12c3ff8c 100644
--- a/test/optional_test_fail3.cpp
+++ b/test/optional_test_fail3.cpp
@@ -15,7 +15,7 @@
 // THIS TEST SHOULD FAIL TO COMPILE
 //
 #if BOOST_WORKAROUND( BOOST_INTEL_CXX_VERSION, <= 700) // Intel C++ 7.0
-// Interl C++ 7.0 incorrectly accepts the initialization "boost::optional opt = 3"
+// Intel C++ 7.0 incorrectly accepts the initialization "boost::optional opt = 3"
 // even though the ctor is explicit (c.f. 12.3.1.2), so the test uses another form of
 // copy-initialization: argument-passing (8.5.12)
 void helper ( boost::optional ) ;

From c76b73c48bb05dccf2a6b71642a8aaaacc6f9217 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:29 -0400
Subject: [PATCH 058/163] spelling: management

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 test/optional_test_common.hpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/test/optional_test_common.hpp b/test/optional_test_common.hpp
index 943e6460..389ad67c 100644
--- a/test/optional_test_common.hpp
+++ b/test/optional_test_common.hpp
@@ -58,7 +58,7 @@ using boost::get_pointer ;
 #define ARG(T) (static_cast< T const* >(0))
 
 //
-// Helper class used to verify the lifetime managment of the values held by optional
+// Helper class used to verify the lifetime management of the values held by optional
 //
 class X
 {

From 581c43f25c8364765aa2c909425cc944d109d1a3 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:29 -0400
Subject: [PATCH 059/163] spelling: member

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 doc/1A_on_performance.qbk                                       | 2 +-
 .../boost_optional/tutorial/performance_considerations.html     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/1A_on_performance.qbk b/doc/1A_on_performance.qbk
index 968b18fe..f254f09d 100644
--- a/doc/1A_on_performance.qbk
+++ b/doc/1A_on_performance.qbk
@@ -86,7 +86,7 @@ Which gives us the following layout (and smaller total size):
 
 [$images/opt_align3.png]
 
-Sometimes it requires detailed consideration what data we make optional. In our case above, if we determine that both minimum and maximum value can be provided or not provided together, but one is never provided without the other, we can make only one optional memebr:
+Sometimes it requires detailed consideration what data we make optional. In our case above, if we determine that both minimum and maximum value can be provided or not provided together, but one is never provided without the other, we can make only one optional member:
 
   struct Limits
   {
diff --git a/doc/html/boost_optional/tutorial/performance_considerations.html b/doc/html/boost_optional/tutorial/performance_considerations.html
index 975a7388..f6e7fb42 100644
--- a/doc/html/boost_optional/tutorial/performance_considerations.html
+++ b/doc/html/boost_optional/tutorial/performance_considerations.html
@@ -165,7 +165,7 @@ 
      
         Sometimes it requires detailed consideration what data we make optional.
         In our case above, if we determine that both minimum and maximum value can
         be provided or not provided together, but one is never provided without the
-        other, we can make only one optional memebr:
+        other, we can make only one optional member:
       
      
 
      struct Limits
 {

From 168552e021d97807a299996c05c7ac985a954389 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 22:02:03 -0400
Subject: [PATCH 060/163] spelling: msvc

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 include/boost/optional/detail/optional_config.hpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/include/boost/optional/detail/optional_config.hpp b/include/boost/optional/detail/optional_config.hpp
index 09835cd8..caa4ce67 100644
--- a/include/boost/optional/detail/optional_config.hpp
+++ b/include/boost/optional/detail/optional_config.hpp
@@ -53,7 +53,7 @@
 #endif
 
 #if (defined(_MSC_VER) && _MSC_VER <= 1800)
-// on MSCV 2013 and earlier an unwanted temporary is created when you assign from
+// on MSVC 2013 and earlier an unwanted temporary is created when you assign from
 // a const lvalue of integral type. Thus we bind not to the original address but
 // to a temporary. 
 # define BOOST_OPTIONAL_CONFIG_NO_PROPER_ASSIGN_FROM_CONST_INT

From ba1846abd379643283403a713a3693839f9bedfd Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:30 -0400
Subject: [PATCH 061/163] spelling: necessarily

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 test/optional_test.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/test/optional_test.cpp b/test/optional_test.cpp
index db89c680..80beb411 100644
--- a/test/optional_test.cpp
+++ b/test/optional_test.cpp
@@ -450,7 +450,7 @@ void test_throwing_val_assign_on_initialized( T const* )
   {
     // This should:
     //   Attempt to assign 'a' and throw.
-    //   opt is kept initialized but its value not neccesarily fully assigned
+    //   opt is kept initialized but its value not necessarily fully assigned
     //   (in this test, incompletely assigned is flagged with the value -1 being set)
     set_pending_assign( ARG(T) ) ;
     opt.reset ( a ) ;
@@ -575,7 +575,7 @@ void test_throwing_assign_to_initialized( T const* )
   {
     // This should:
     //   Attempt to copy construct 'opt1.value()' into opt0 and throw.
-    //   opt0 is kept initialized but its value not neccesarily fully assigned
+    //   opt0 is kept initialized but its value not necessarily fully assigned
     //   (in this test, incompletely assigned is flagged with the value -1 being set)
     set_pending_assign( ARG(T) ) ;
     opt0 = opt1 ;

From a4479bf8cd4729a83fc3195144975ce96b78e27a Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:34:50 -0400
Subject: [PATCH 062/163] spelling: nonexistent

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 doc/01_quick_start.qbk                                          | 2 +-
 doc/html/boost_optional/quick_start.html                        | 2 +-
 doc/html/boost_optional/quick_start/optional_return_values.html | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/01_quick_start.qbk b/doc/01_quick_start.qbk
index 6341e614..ae5f828c 100644
--- a/doc/01_quick_start.qbk
+++ b/doc/01_quick_start.qbk
@@ -44,7 +44,7 @@ This is because we know that string value `"100"` converts to a valid value of `
       // deal with it
     }
 
-This version throws an exception upon an attempt to access a non-existent contained value. If your way of dealing with the missing value is to use some default, like `0`, there exists a yet another alternative:
+This version throws an exception upon an attempt to access a nonexistent contained value. If your way of dealing with the missing value is to use some default, like `0`, there exists a yet another alternative:
 
     int k = convert(text).value_or(0);
 
diff --git a/doc/html/boost_optional/quick_start.html b/doc/html/boost_optional/quick_start.html
index dd8491aa..0388d430 100644
--- a/doc/html/boost_optional/quick_start.html
+++ b/doc/html/boost_optional/quick_start.html
@@ -100,7 +100,7 @@
 }
 
      
 
      
-        This version throws an exception upon an attempt to access a non-existent
+        This version throws an exception upon an attempt to access a nonexistent
         contained value. If your way of dealing with the missing value is to use
         some default, like 0, there exists
         a yet another alternative:
diff --git a/doc/html/boost_optional/quick_start/optional_return_values.html b/doc/html/boost_optional/quick_start/optional_return_values.html
index 9ad85ef1..fef09ffd 100644
--- a/doc/html/boost_optional/quick_start/optional_return_values.html
+++ b/doc/html/boost_optional/quick_start/optional_return_values.html
@@ -84,7 +84,7 @@
 }

      - This version throws an exception upon an attempt to access a non-existent + This version throws an exception upon an attempt to access a nonexistent contained value. If your way of dealing with the missing value is to use some default, like 0, there exists a yet another alternative: From 599c72f23bfdc7c40940f056059597c32ced2bd8 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Tue, 1 Nov 2022 21:46:30 -0400 Subject: [PATCH 063/163] spelling: occur Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- doc/15_optional_references.qbk | 2 +- doc/html/boost_optional/optional_references.html | 2 +- doc/html/boost_optional/tutorial/optional_references.html | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/15_optional_references.qbk b/doc/15_optional_references.qbk index acb1226f..af663e1b 100644 --- a/doc/15_optional_references.qbk +++ b/doc/15_optional_references.qbk @@ -16,7 +16,7 @@ some operations are not available in this case: * Value-access via pointer Also, even though `optional` treats it wrapped pseudo-object much as -a real value, a true real reference is stored so aliasing will ocurr: +a real value, a true real reference is stored so aliasing will occur: * Copies of `optional` will copy the references but all these references will nonetheless refer to the same object. diff --git a/doc/html/boost_optional/optional_references.html b/doc/html/boost_optional/optional_references.html index 4da272ed..5ff61bf8 100644 --- a/doc/html/boost_optional/optional_references.html +++ b/doc/html/boost_optional/optional_references.html @@ -55,7 +55,7 @@

      Also, even though optional<T&> treats it wrapped pseudo-object much as a real value, a true real reference - is stored so aliasing will ocurr: + is stored so aliasing will occur:

      • diff --git a/doc/html/boost_optional/tutorial/optional_references.html b/doc/html/boost_optional/tutorial/optional_references.html index 595303ee..ff16598d 100644 --- a/doc/html/boost_optional/tutorial/optional_references.html +++ b/doc/html/boost_optional/tutorial/optional_references.html @@ -59,7 +59,7 @@

        Also, even though optional<T&> treats it wrapped pseudo-object much as a real value, a true real reference is stored so aliasing will - ocurr: + occur:

        • From 4b63acfc10dafb352f4258c4639454481774c086 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Tue, 1 Nov 2022 21:46:31 -0400 Subject: [PATCH 064/163] spelling: optional Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- doc/13_relational_operators.qbk | 2 +- doc/1A_on_performance.qbk | 2 +- doc/28_ref_optional_semantics.qbk | 2 +- doc/91_relnotes.qbk | 4 ++-- .../quick_start/optional_return_values.html | 8 ++++---- .../detailed_semantics.html | 2 +- .../detailed_semantics____free_functions.html | 2 +- .../detailed_semantics___free_functions.html | 2 +- doc/html/boost_optional/relnotes.html | 2 +- .../tutorial/performance_considerations.html | 2 +- .../boost_optional/tutorial/relational_operators.html | 2 +- test/optional_test_deleted_default_ctor.cpp | 2 +- test/optional_test_tc_base.cpp | 4 ++-- 13 files changed, 18 insertions(+), 18 deletions(-) diff --git a/doc/13_relational_operators.qbk b/doc/13_relational_operators.qbk index fda77000..3336bec0 100644 --- a/doc/13_relational_operators.qbk +++ b/doc/13_relational_operators.qbk @@ -13,7 +13,7 @@ Type `optional` is __STD_EQUALITY_COMPARABLE__ whenever `T` is __STD_EQUALITY assert(oN == oN); assert(o0 == o0); -The converting constructor from `T` as well as from `boost::none` implies the existence and semantics of the mixed comparison between `T` and `optional` as well as between `none_t` and `optionl`: +The converting constructor from `T` as well as from `boost::none` implies the existence and semantics of the mixed comparison between `T` and `optional` as well as between `none_t` and `optional`: assert(oN != 0); assert(o1 != boost::none); diff --git a/doc/1A_on_performance.qbk b/doc/1A_on_performance.qbk index f254f09d..2c413614 100644 --- a/doc/1A_on_performance.qbk +++ b/doc/1A_on_performance.qbk @@ -19,7 +19,7 @@ Lifetime of the `T` inside `_storage` is manually controlled with placement-`new T _storage; }; -We call it a ['direct] storage. This makes `optional` a trivially-copyable type for scalar `T`s. This only works for compilers that support defaulted functions (including defaulted move assignment and constructor). On compilers without defaulted functions we still use the direct storage, but `optional` is no longer recognized as trivially-copyable. Apart from scalar types, we leave the programmer a way of customizing her type, so that it is reconized by `optional` as candidate for optimized storage, by specializing type trait `boost::opitonal_config::optional_uses_direct_storage_for`: +We call it a ['direct] storage. This makes `optional` a trivially-copyable type for scalar `T`s. This only works for compilers that support defaulted functions (including defaulted move assignment and constructor). On compilers without defaulted functions we still use the direct storage, but `optional` is no longer recognized as trivially-copyable. Apart from scalar types, we leave the programmer a way of customizing her type, so that it is reconized by `optional` as candidate for optimized storage, by specializing type trait `boost::optional_config::optional_uses_direct_storage_for`: struct X // not trivial { diff --git a/doc/28_ref_optional_semantics.qbk b/doc/28_ref_optional_semantics.qbk index e55771b6..8c4fd976 100644 --- a/doc/28_ref_optional_semantics.qbk +++ b/doc/28_ref_optional_semantics.qbk @@ -1249,7 +1249,7 @@ __SPACE__ * [*Returns:] `(!y) ? false : (!x) ? true : *x < *y`. * [*Notes:] This definition guarantees that `optional` not containing a value is ordered as less than any `optional` containing any value, and equivalent to any other `optional` not containing a value. Pointers have shallow relational operators while `optional` has deep relational operators. Do not use `operator<` directly in generic code -which expect to be given either an `optional` or a pointer; use __FUNCTION_LESS_POINTEES__ instead. `T` need not be __STD_LESS_THAN_COMPARABLE__. Only single `operator<` is required. Other relational operations are defined in terms of this one. If `T`'s `operator<` satisfies the axioms of __STD_LESS_THAN_COMPARABLE__ (transitivity, antisymmetry and irreflexivity), `optinal` is __STD_LESS_THAN_COMPARABLE__. +which expect to be given either an `optional` or a pointer; use __FUNCTION_LESS_POINTEES__ instead. `T` need not be __STD_LESS_THAN_COMPARABLE__. Only single `operator<` is required. Other relational operations are defined in terms of this one. If `T`'s `operator<` satisfies the axioms of __STD_LESS_THAN_COMPARABLE__ (transitivity, antisymmetry and irreflexivity), `optional` is __STD_LESS_THAN_COMPARABLE__. * [*Example:] `` optional oN, oN_; diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index 5c8fa3fa..a52e3cef 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -13,7 +13,7 @@ [heading Boost Release 1.80] -* [*Breaking change:] Added specializations for `std::hash>`. This fixes [@https://github.com/boostorg/optional/issues/55 issue #55]. You may get compiler errors when your program provides specializations for `std::hash>`. If this happens, define macro `BOOST_OPTIONAL_CONFIG_DO_NOT_SPECIALIZE_STD_HASH` to suppress the specializations of `std::hash` in this library. +* [*Breaking change:] Added specializations for `std::hash>`. This fixes [@https://github.com/boostorg/optional/issues/55 issue #55]. You may get compiler errors when your program provides specializations for `std::hash>`. If this happens, define macro `BOOST_OPTIONAL_CONFIG_DO_NOT_SPECIALIZE_STD_HASH` to suppress the specializations of `std::hash` in this library. [heading Boost Release 1.79] @@ -50,7 +50,7 @@ * Added member function `has_value()` for compatibility with `std::optional` ([@https://github.com/boostorg/optional/issues/52 issue #52]). * Added member function `map()` for transforming `optional` into `optional` using a function of type `T -> U`. -* Added member function `flat_map()` for transforming `optional` into `optional` using a function of type `T -> optonal`. +* Added member function `flat_map()` for transforming `optional` into `optional` using a function of type `T -> optional`. [heading Boost Release 1.67] diff --git a/doc/html/boost_optional/quick_start/optional_return_values.html b/doc/html/boost_optional/quick_start/optional_return_values.html index fef09ffd..b9953e7e 100644 --- a/doc/html/boost_optional/quick_start/optional_return_values.html +++ b/doc/html/boost_optional/quick_start/optional_return_values.html @@ -37,7 +37,7 @@ is possible. A natural signature for this function can be: 

          #include <boost/optional.hpp>
-boost::optionl<int> convert(const std::string& text);
+boost::optional<int> convert(const std::string& text);

          All necessary functionality can be included with one header <boost/optional.hpp>. @@ -49,7 +49,7 @@ can use our function: 

          const std::string& text = /*... */;
-boost::optionl<int> oi = convert(text); // move-construct
+boost::optional<int> oi = convert(text); // move-construct
 if (oi)                                 // contextual conversion to bool
   int i = *oi;                          // operator*
          @@ -58,7 +58,7 @@ contains a value, we use the contextual conversion to type bool. Because of this we can combine the initialization of the optional object and the test into one instruction:

          -
          if (boost::optionl<int> oi = convert(text))
+
          if (boost::optional<int> oi = convert(text))
   int i = *oi;
 
          
 
          
@@ -98,7 +98,7 @@
         Now, let's consider how function convert
         can be implemented.
       
          
-
          boost::optionl<int> convert(const std::string& text)
+
          boost::optional<int> convert(const std::string& text)
 {
   std::stringstream s(text);
   int i;
diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html
index b7d25f5b..e893e19d 100644
--- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html
+++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html
@@ -2129,7 +2129,7 @@ 
          
               is required. Other relational operations are defined in terms of this
               one. If T's operator<
               satisfies the axioms of LessThanComparable (transitivity,
-              antisymmetry and irreflexivity), optinal<T> is LessThanComparable.
+              antisymmetry and irreflexivity), optional<T> is LessThanComparable.
        • Example: diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____free_functions.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____free_functions.html index 462f1093..768d6900 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____free_functions.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____free_functions.html @@ -153,7 +153,7 @@ is required. Other relational operations are defined in terms of this one. If T's operator< satisfies the axioms of LessThanComparable (transitivity, - antisymmetry and irreflexivity), optinal<T> is LessThanComparable. + antisymmetry and irreflexivity), optional<T> is LessThanComparable.
        • Example: diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html index 2781080e..e1f7d4eb 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html @@ -179,7 +179,7 @@ is required. Other relational operations are defined in terms of this one. If T's operator< satisfies the axioms of LessThanComparable (transitivity, - antisymmetry and irreflexivity), optinal<T> is LessThanComparable. + antisymmetry and irreflexivity), optional<T> is LessThanComparable.
        • Example: diff --git a/doc/html/boost_optional/relnotes.html b/doc/html/boost_optional/relnotes.html index f59b5e6a..e90dcc5b 100644 --- a/doc/html/boost_optional/relnotes.html +++ b/doc/html/boost_optional/relnotes.html @@ -131,7 +131,7 @@

          Added member function map() for transforming optional<T> into optional<U> using a function of type T -> U.

        • - Added member function flat_map() for transforming optional<T> into optional<U> using a function of type T -> optonal<U>. + Added member function flat_map() for transforming optional<T> into optional<U> using a function of type T -> optional<U>.

        diff --git a/doc/html/boost_optional/tutorial/performance_considerations.html b/doc/html/boost_optional/tutorial/performance_considerations.html index f6e7fb42..7d1e0f85 100644 --- a/doc/html/boost_optional/tutorial/performance_considerations.html +++ b/doc/html/boost_optional/tutorial/performance_considerations.html @@ -62,7 +62,7 @@ is no longer recognized as trivially-copyable. Apart from scalar types, we leave the programmer a way of customizing her type, so that it is reconized by optional as candidate - for optimized storage, by specializing type trait boost::opitonal_config::optional_uses_direct_storage_for: + for optimized storage, by specializing type trait boost::optional_config::optional_uses_direct_storage_for: 

        struct X // not trivial
 {
diff --git a/doc/html/boost_optional/tutorial/relational_operators.html b/doc/html/boost_optional/tutorial/relational_operators.html
index ddb68707..e384ab07 100644
--- a/doc/html/boost_optional/tutorial/relational_operators.html
+++ b/doc/html/boost_optional/tutorial/relational_operators.html
@@ -51,7 +51,7 @@
         of the mixed comparison between T
         and optional<T> as
         well as between none_t and
-        optionl<T>:
+        optional<T>:
       
        
 
        assert(oN != 0);
 assert(o1 != boost::none);
diff --git a/test/optional_test_deleted_default_ctor.cpp b/test/optional_test_deleted_default_ctor.cpp
index 1fe2bdb6..ec38b913 100644
--- a/test/optional_test_deleted_default_ctor.cpp
+++ b/test/optional_test_deleted_default_ctor.cpp
@@ -22,7 +22,7 @@ int main()
 class basic_multi_buffer;
 
 class const_buffers_type // a similar declaration in boost.beast had problem
-{                        // with boost opitonal
+{                        // with boost optional
     basic_multi_buffer const* b_;
 
     friend class basic_multi_buffer;
diff --git a/test/optional_test_tc_base.cpp b/test/optional_test_tc_base.cpp
index 8c78dc0c..60463959 100644
--- a/test/optional_test_tc_base.cpp
+++ b/test/optional_test_tc_base.cpp
@@ -70,7 +70,7 @@ void test_value_init()
 	}
 }
 
-void test_optoinal_reference_wrapper()
+void test_optional_reference_wrapper()
 {
 	boost::optional > o;
 	BOOST_TEST(boost::none == o);
@@ -80,7 +80,7 @@ int main()
 {
   test_tc_base();
   test_value_init();
-  test_optoinal_reference_wrapper();
+  test_optional_reference_wrapper();
   return boost::report_errors();
 }
 

From deda20af892f0fa9404d8942630a0b34403c51af Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:31 -0400
Subject: [PATCH 065/163] spelling: overloads

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 doc/90_dependencies.qbk                                         | 2 +-
 .../emplace_operations_in_older_compilers.html                  | 2 +-
 include/boost/optional/detail/old_optional_implementation.hpp   | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/90_dependencies.qbk b/doc/90_dependencies.qbk
index 8e3e8ded..d383905c 100644
--- a/doc/90_dependencies.qbk
+++ b/doc/90_dependencies.qbk
@@ -46,7 +46,7 @@ On compilers that do not support variadic templates, each of these functions is
     template void emplace(Arg&& arg);
     void emplace();
 
-On compilers that do not support rvalue references, each of these functions is substituted with three overloadss: taking `const` and non-`const` lvalue reference, and third forwarding zero arguments. This forms the following set:
+On compilers that do not support rvalue references, each of these functions is substituted with three overloads: taking `const` and non-`const` lvalue reference, and third forwarding zero arguments. This forms the following set:
 
     template optional(in_place_init_t, const Arg& arg);
     template optional(in_place_init_t, Arg& arg);
diff --git a/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html b/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html
index 7d6d4074..e4c08bcb 100644
--- a/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html
+++ b/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html
@@ -52,7 +52,7 @@
 
        
 
        
         On compilers that do not support rvalue references, each of these functions
-        is substituted with three overloadss: taking const
+        is substituted with three overloads: taking const
         and non-const lvalue reference,
         and third forwarding zero arguments. This forms the following set:
       
        
diff --git a/include/boost/optional/detail/old_optional_implementation.hpp b/include/boost/optional/detail/old_optional_implementation.hpp
index 2b7da28e..6d707fc0 100644
--- a/include/boost/optional/detail/old_optional_implementation.hpp
+++ b/include/boost/optional/detail/old_optional_implementation.hpp
@@ -629,7 +629,7 @@ class optional_base : public optional_tag
 
     // If T is of reference type, trying to get a pointer to the held value must result in a compile-time error.
     // Decent compilers should disallow conversions from reference_content* to T*, but just in case,
-    // the following olverloads are used to filter out the case and guarantee an error in case of T being a reference.
+    // the following overloads are used to filter out the case and guarantee an error in case of T being a reference.
     pointer_const_type cast_ptr( internal_type const* p, is_not_reference_tag ) const { return p ; }
     pointer_type       cast_ptr( internal_type *      p, is_not_reference_tag )       { return p ; }
     pointer_const_type cast_ptr( internal_type const* p, is_reference_tag     ) const { return &p->get() ; }

From 8ffb7e3f5724e9758232b604644c4aeda2044ec9 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 22:02:49 -0400
Subject: [PATCH 066/163] spelling: pointees

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 include/boost/optional/detail/optional_relops.hpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/include/boost/optional/detail/optional_relops.hpp b/include/boost/optional/detail/optional_relops.hpp
index 2c17f2b7..1c155787 100644
--- a/include/boost/optional/detail/optional_relops.hpp
+++ b/include/boost/optional/detail/optional_relops.hpp
@@ -16,7 +16,7 @@
 namespace boost {
 
 // optional's relational operators ( ==, !=, <, >, <=, >= ) have deep-semantics (compare values).
-// WARNING: This is UNLIKE pointers. Use equal_pointees()/less_pointess() in generic code instead.
+// WARNING: This is UNLIKE pointers. Use equal_pointees()/less_pointees() in generic code instead.
 
 
 //

From db472e7ed62d6460548d559961cc05553fc119ac Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:34 -0400
Subject: [PATCH 067/163] spelling: recognized

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 doc/1A_on_performance.qbk                                       | 2 +-
 .../boost_optional/tutorial/performance_considerations.html     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/1A_on_performance.qbk b/doc/1A_on_performance.qbk
index 2c413614..fc3bf8b3 100644
--- a/doc/1A_on_performance.qbk
+++ b/doc/1A_on_performance.qbk
@@ -19,7 +19,7 @@ Lifetime of the `T` inside `_storage` is manually controlled with placement-`new
     T _storage;
   };
 
-We call it a ['direct] storage. This makes `optional` a trivially-copyable type for scalar `T`s. This only works for compilers that support defaulted functions (including defaulted move assignment and constructor). On compilers without defaulted functions we still use the direct storage, but `optional` is no longer recognized as trivially-copyable. Apart from scalar types, we leave the programmer a way of customizing her type, so that it is reconized by `optional` as candidate for optimized storage, by specializing type trait `boost::optional_config::optional_uses_direct_storage_for`:
+We call it a ['direct] storage. This makes `optional` a trivially-copyable type for scalar `T`s. This only works for compilers that support defaulted functions (including defaulted move assignment and constructor). On compilers without defaulted functions we still use the direct storage, but `optional` is no longer recognized as trivially-copyable. Apart from scalar types, we leave the programmer a way of customizing her type, so that it is recognized by `optional` as candidate for optimized storage, by specializing type trait `boost::optional_config::optional_uses_direct_storage_for`:
 
   struct X // not trivial
   {
diff --git a/doc/html/boost_optional/tutorial/performance_considerations.html b/doc/html/boost_optional/tutorial/performance_considerations.html
index 7d1e0f85..e20cf61a 100644
--- a/doc/html/boost_optional/tutorial/performance_considerations.html
+++ b/doc/html/boost_optional/tutorial/performance_considerations.html
@@ -60,7 +60,7 @@
         defaulted move assignment and constructor). On compilers without defaulted
         functions we still use the direct storage, but optional<T>
         is no longer recognized as trivially-copyable. Apart from scalar types, we
-        leave the programmer a way of customizing her type, so that it is reconized
+        leave the programmer a way of customizing her type, so that it is recognized
         by optional as candidate
         for optimized storage, by specializing type trait boost::optional_config::optional_uses_direct_storage_for:
       
        

From cdc2bd8482dc2abb085046209eddf0e9c545ec3b Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:35 -0400
Subject: [PATCH 068/163] spelling: references

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 include/boost/optional/detail/optional_reference_spec.hpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/include/boost/optional/detail/optional_reference_spec.hpp b/include/boost/optional/detail/optional_reference_spec.hpp
index 0069c79b..622f7678 100644
--- a/include/boost/optional/detail/optional_reference_spec.hpp
+++ b/include/boost/optional/detail/optional_reference_spec.hpp
@@ -66,7 +66,7 @@ void prevent_assignment_from_false_const_integral()
 {
 #ifndef BOOST_OPTIONAL_CONFIG_ALLOW_BINDING_TO_RVALUES
 #ifdef BOOST_OPTIONAL_CONFIG_NO_PROPER_ASSIGN_FROM_CONST_INT
-    // MSVC compiler without rvalue refernces: we need to disable the assignment from
+    // MSVC compiler without rvalue references: we need to disable the assignment from
     // const integral lvalue reference, as it may be an invalid temporary
     BOOST_STATIC_ASSERT_MSG(!is_const_integral::value, 
                             "binding const lvalue references to integral types is disabled in this compiler");

From 630cf7f7b52f51db88105927670bb6de10b2c552 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:35 -0400
Subject: [PATCH 069/163] spelling: referred

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 doc/28_ref_optional_semantics.qbk                               | 2 +-
 .../detailed_semantics.html                                     | 2 +-
 .../detailed_semantics____free_functions.html                   | 2 +-
 .../detailed_semantics___free_functions.html                    | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/doc/28_ref_optional_semantics.qbk b/doc/28_ref_optional_semantics.qbk
index 8c4fd976..cb3d8c60 100644
--- a/doc/28_ref_optional_semantics.qbk
+++ b/doc/28_ref_optional_semantics.qbk
@@ -1386,7 +1386,7 @@ __SPACE__
 [#reference_swap_optional_reference]
 [: `void swap ( optional& x, optional& y ) noexcept ;`]
 
-* [*Postconditions:] `x` refers to what `y` refererred to before the swap (if anything). `y` refers to whatever `x` referred to before the swap.
+* [*Postconditions:] `x` refers to what `y` referred to before the swap (if anything). `y` refers to whatever `x` referred to before the swap.
 
 * [*Example:]
 ``
diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html
index e893e19d..780f6f34 100644
--- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html
+++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html
@@ -2380,7 +2380,7 @@ 
        
 
          
 
        • 
               Postconditions: x
-              refers to what y refererred
+              refers to what y referred
               to before the swap (if anything). y
               refers to whatever x
               referred to before the swap.
diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____free_functions.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____free_functions.html
index 768d6900..b3c6401d 100644
--- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____free_functions.html
+++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____free_functions.html
@@ -404,7 +404,7 @@
 
            
 
          • 
               Postconditions: x
-              refers to what y refererred
+              refers to what y referred
               to before the swap (if anything). y
               refers to whatever x
               referred to before the swap.
diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html
index e1f7d4eb..776cffbb 100644
--- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html
+++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html
@@ -479,7 +479,7 @@
 
              
 
            • 
               Postconditions: x
-              refers to what y refererred
+              refers to what y referred
               to before the swap (if anything). y
               refers to whatever x
               referred to before the swap.

From 7e395f4520f6d7357d7aff670cba59ba80854181 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:37 -0400
Subject: [PATCH 070/163] spelling: screwed

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 include/boost/optional/detail/optional_reference_spec.hpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/include/boost/optional/detail/optional_reference_spec.hpp b/include/boost/optional/detail/optional_reference_spec.hpp
index 622f7678..b013f0b5 100644
--- a/include/boost/optional/detail/optional_reference_spec.hpp
+++ b/include/boost/optional/detail/optional_reference_spec.hpp
@@ -130,7 +130,7 @@ class optional : public optional_detail::optional_tag
         explicit optional(const optional& rhs) BOOST_NOEXCEPT : ptr_(rhs.get_ptr()) {}
     optional(const optional& rhs) BOOST_NOEXCEPT : ptr_(rhs.get_ptr()) {}
     
-    // the following two implement a 'conditionally explicit' constructor: condition is a hack for buggy compilers with srewed conversion construction from const int
+    // the following two implement a 'conditionally explicit' constructor: condition is a hack for buggy compilers with screwed conversion construction from const int
     template 
       explicit optional(U& rhs, BOOST_DEDUCED_TYPENAME boost::enable_if_c::value && detail::is_const_integral_bad_for_conversion::value, bool>::type = true) BOOST_NOEXCEPT
       : ptr_(boost::addressof(rhs)) {}

From b4c8f493c6ad839dade05108b96358b79b59d753 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:36 -0400
Subject: [PATCH 071/163] spelling: shallow

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 doc/91_relnotes.qbk                   | 2 +-
 doc/html/boost_optional/relnotes.html | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk
index a52e3cef..135be495 100644
--- a/doc/91_relnotes.qbk
+++ b/doc/91_relnotes.qbk
@@ -82,7 +82,7 @@
   * the `sizeof` of optional reference is that of a pointer,
   * some bugs connected to copying optional references are gone,
   * all run-time bugs caused by incorrect reference binding on some compilers are now turned into compile-time errors,
-  * you can swap optional references: it is like swapping pointers: shalow, underlying objects are not affected,
+  * you can swap optional references: it is like swapping pointers: shallow, underlying objects are not affected,
   * optional references to abstract types work.
 * Documented nested typedefs ([@https://svn.boost.org/trac/boost/ticket/5193 Trac #5193]).
 * Made the perfect-forwarding constructor SFINAE-friendly, which fixes [@https://svn.boost.org/trac/boost/ticket/12002 Trac #12002]. However, this only works in the newer platforms that correctly implement C++11 ``.
diff --git a/doc/html/boost_optional/relnotes.html b/doc/html/boost_optional/relnotes.html
index e90dcc5b..8acd8388 100644
--- a/doc/html/boost_optional/relnotes.html
+++ b/doc/html/boost_optional/relnotes.html
@@ -220,7 +220,7 @@ 
              
                 are now turned into compile-time errors,
               
              • 
 
            • 
-                you can swap optional references: it is like swapping pointers: shalow,
+                you can swap optional references: it is like swapping pointers: shallow,
                 underlying objects are not affected,
               
              • 
 
            • 

From ce500ee4363f27bb12d4c3734ce322549874dd01 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:36 -0400
Subject: [PATCH 072/163] spelling: specialization

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 doc/27_ref_optional_synopsis.qbk                                | 2 +-
 .../header_optional_optional_refs.html                          | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/27_ref_optional_synopsis.qbk b/doc/27_ref_optional_synopsis.qbk
index 9be5846c..d86967bd 100644
--- a/doc/27_ref_optional_synopsis.qbk
+++ b/doc/27_ref_optional_synopsis.qbk
@@ -228,7 +228,7 @@ They are empty, trivially copyable classes with disabled default constructor.
 
 [#reference_operator_template_spec]
     template 
-    class optional // specilization for lvalue references
+    class optional // specialization for lvalue references
     {
     public :
 
diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html
index 34729158..3244e972 100644
--- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html
+++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html
@@ -28,7 +28,7 @@
         References
 

      template <class T>
-class optional<T&> // specilization for lvalue references
+class optional<T&> // specialization for lvalue references
 {
 public :
 

From 653ebefbac7c1b737b130f4cde55e28cf9d2a70f Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:37 -0400
Subject: [PATCH 073/163] spelling: support

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 doc/28_ref_optional_semantics.qbk                         | 8 ++++----
 .../detailed_semantics___optional_references.html         | 2 +-
 .../detailed_semantics___optional_values.html             | 6 +++---
 include/boost/optional/detail/optional_config.hpp         | 2 +-
 4 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/doc/28_ref_optional_semantics.qbk b/doc/28_ref_optional_semantics.qbk
index cb3d8c60..e4915437 100644
--- a/doc/28_ref_optional_semantics.qbk
+++ b/doc/28_ref_optional_semantics.qbk
@@ -233,7 +233,7 @@ __SPACE__
 arguments `std::forward(args)...`.
 * [*Postconditions:] `*this` is initialized.
 * [*Throws:] Any exception thrown by the selected constructor of `T`.
-* [*Notes: ] `T` need not be __MOVE_CONSTRUCTIBLE__. On compilers that do not suppor variadic templates or rvalue references, this constuctor is available in limited functionality. For details [link optional_emplace_workaround see here].
+* [*Notes: ] `T` need not be __MOVE_CONSTRUCTIBLE__. On compilers that do not support variadic templates or rvalue references, this constuctor is available in limited functionality. For details [link optional_emplace_workaround see here].
 
 * [*Example:]
 ``
@@ -257,7 +257,7 @@ __SPACE__
 * [*Effect:] If `condition` is `true`, initializes the contained value as if direct-non-list-initializing an object of type `T` with the arguments `std::forward(args)...`.
 * [*Postconditions:] `bool(*this) == condition`.
 * [*Throws:] Any exception thrown by the selected constructor of `T`.
-* [*Notes: ] `T` need not be __MOVE_CONSTRUCTIBLE__. On compilers that do not suppor variadic templates or rvalue references, this constuctor is available in limited functionality. For details [link optional_emplace_workaround see here].
+* [*Notes: ] `T` need not be __MOVE_CONSTRUCTIBLE__. On compilers that do not support variadic templates or rvalue references, this constuctor is available in limited functionality. For details [link optional_emplace_workaround see here].
 
 * [*Example:]
 ``
@@ -502,7 +502,7 @@ __SPACE__
 * [*Postconditions: ] `*this` is [_initialized].
 * [*Throws:] Whatever the selected `T`'s  constructor throws.
 * [*Exception Safety:] If an exception is thrown during the initialization of `T`, `*this` is ['uninitialized].
-* [*Notes:] `T` need not be __MOVE_CONSTRUCTIBLE__ or `MoveAssignable`. On compilers that do not suppor variadic templates or rvalue references, this function is available in limited functionality. For details [link optional_emplace_workaround see here].
+* [*Notes:] `T` need not be __MOVE_CONSTRUCTIBLE__ or `MoveAssignable`. On compilers that do not support variadic templates or rvalue references, this function is available in limited functionality. For details [link optional_emplace_workaround see here].
 * [*Example:]
 ``
 T v;
@@ -875,7 +875,7 @@ __SPACE__
 [: `template optional::optional(R&& r) noexcept;`]
 * [*Postconditions:] `bool(*this) == true`; `addressof(**this) == addressof(r)`.
 * [*Remarks:] Unless `R` is an lvalue reference, the program is ill-formed. This constructor does not participate in overload resolution if `decay` is an instance of `boost::optional`.
-* [*Notes:] This constructor is declared `explicit` on compilers that do not correctly suport binding to const lvalues of integral types. For more details [link optional_reference_binding see here].
+* [*Notes:] This constructor is declared `explicit` on compilers that do not correctly support binding to const lvalues of integral types. For more details [link optional_reference_binding see here].
 * [*Example:]
 ``
 T v;
diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html
index 42d7e20b..3a4d5fef 100644
--- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html
+++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html
@@ -58,7 +58,7 @@
 
    • 
               Notes: This constructor is declared
               explicit on compilers
-              that do not correctly suport binding to const lvalues of integral types.
+              that do not correctly support binding to const lvalues of integral types.
               For more details see here.
             
      • 
 
    • 
diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html
index b6e02272..c0b8e6bd 100644
--- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html
+++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html
@@ -429,7 +429,7 @@
 
    • 
               Notes:  T
               need not be MoveConstructible.
-              On compilers that do not suppor variadic templates or rvalue references,
+              On compilers that do not support variadic templates or rvalue references,
               this constuctor is available in limited functionality. For details
               see here.
             
      • 
@@ -476,7 +476,7 @@
 
    • 
               Notes:  T
               need not be MoveConstructible.
-              On compilers that do not suppor variadic templates or rvalue references,
+              On compilers that do not support variadic templates or rvalue references,
               this constuctor is available in limited functionality. For details
               see here.
             
      • 
@@ -1125,7 +1125,7 @@
               Notes: T
               need not be MoveConstructible
               or MoveAssignable.
-              On compilers that do not suppor variadic templates or rvalue references,
+              On compilers that do not support variadic templates or rvalue references,
               this function is available in limited functionality. For details see here.
             
 
    • 
diff --git a/include/boost/optional/detail/optional_config.hpp b/include/boost/optional/detail/optional_config.hpp
index caa4ce67..b5040a47 100644
--- a/include/boost/optional/detail/optional_config.hpp
+++ b/include/boost/optional/detail/optional_config.hpp
@@ -114,7 +114,7 @@
 #endif
 
 
-// Detect suport for defaulting move operations
+// Detect support for defaulting move operations
 // (some older compilers implement rvalue references,
 // defaulted functions but move operations are not special members and cannot be defaulted)
 

From 668c8d924b8f593c74a84e7f40ebda14d071ef51 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:37 -0400
Subject: [PATCH 074/163] spelling: suppressing

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 doc/91_relnotes.qbk                   | 2 +-
 doc/html/boost_optional/relnotes.html | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk
index 135be495..3a85bd35 100644
--- a/doc/91_relnotes.qbk
+++ b/doc/91_relnotes.qbk
@@ -38,7 +38,7 @@
 * Fixed [@https://github.com/boostorg/optional/issues/78 issue #78].
 * `boost::none` is now declared as an inline variable (on compilers that support it): there is only one instance of `boost::none` across all translation units.
 * Fixed a number of compilation errors in GCC 4.4.7 in `optional` for trivial `T`s. Thanks to Robert Leahy for the fix. For details see [@https://github.com/boostorg/optional/pull/80 pr #78].
-* Now surpressing warning `-Wweak-vtables`.
+* Now suppressing warning `-Wweak-vtables`.
 
 [heading Boost Release 1.69]
 
diff --git a/doc/html/boost_optional/relnotes.html b/doc/html/boost_optional/relnotes.html
index 8acd8388..ae833827 100644
--- a/doc/html/boost_optional/relnotes.html
+++ b/doc/html/boost_optional/relnotes.html
@@ -96,7 +96,7 @@ 
      
           #78.
         
      • 
 
    • 
-          Now surpressing warning -Wweak-vtables.
+          Now suppressing warning -Wweak-vtables.
         
      • 
 
 
      

From 246f1663e12c826d0ed78798b530d331ae7e473d Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:38 -0400
Subject: [PATCH 075/163] spelling: trivially

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 .../boost/optional/detail/optional_trivially_copyable_base.hpp  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/include/boost/optional/detail/optional_trivially_copyable_base.hpp b/include/boost/optional/detail/optional_trivially_copyable_base.hpp
index e8eff70b..8d98a844 100644
--- a/include/boost/optional/detail/optional_trivially_copyable_base.hpp
+++ b/include/boost/optional/detail/optional_trivially_copyable_base.hpp
@@ -9,7 +9,7 @@
 // You are welcome to contact the author at:
 //  akrzemi1@gmail.com
 
-// trivilally-copyable version of the storage
+// trivially-copyable version of the storage
 
 template
 class tc_optional_base : public optional_tag

From 46ad495a608b334d0a0f391cd3785c04b65ea727 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Tue, 1 Nov 2022 21:46:38 -0400
Subject: [PATCH 076/163] spelling: uninitialized

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 doc/01_quick_start.qbk                                        | 2 +-
 doc/html/boost_optional/development.html                      | 4 ++--
 .../quick_start/optional_automatic_variables.html             | 2 +-
 doc/html/boost_optional/tutorial.html                         | 4 ++--
 test/optional_test.cpp                                        | 2 +-
 5 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/doc/01_quick_start.qbk b/doc/01_quick_start.qbk
index ae5f828c..223603dd 100644
--- a/doc/01_quick_start.qbk
+++ b/doc/01_quick_start.qbk
@@ -91,7 +91,7 @@ We could write function `convert` in a slightly different manner, so that it has
       return ans;
     }
 
-The default constructor of `optional` creates an unitialized optional object. Unlike with `int`s you cannot have an `optional` in an indeterminate state. Its state is always well defined. Instruction `ans = i` initializes the optional object. It uses the 'mixed' assignment from `int`. In general, for `optional`, when an assignment from `T` is invoked, it can do two things. If the optional object is not initialized (our case here), it initializes the contained value using `T`'s copy constructor. If the optional object is already initialized, it assigns the new value to it using `T`'s copy assignment.
+The default constructor of `optional` creates an uninitialized optional object. Unlike with `int`s you cannot have an `optional` in an indeterminate state. Its state is always well defined. Instruction `ans = i` initializes the optional object. It uses the 'mixed' assignment from `int`. In general, for `optional`, when an assignment from `T` is invoked, it can do two things. If the optional object is not initialized (our case here), it initializes the contained value using `T`'s copy constructor. If the optional object is already initialized, it assigns the new value to it using `T`'s copy assignment.
 [endsect]
 
 [section Optional data members]
diff --git a/doc/html/boost_optional/development.html b/doc/html/boost_optional/development.html
index 70bc6e44..21e6db44 100644
--- a/doc/html/boost_optional/development.html
+++ b/doc/html/boost_optional/development.html
@@ -293,8 +293,8 @@
       
      
 
      
 
-        Lexically-hinted
-        Value Access in the presence of possibly untitialized optional objects: The
+        Lexically-hinted
+        Value Access in the presence of possibly uninitialized optional objects: The
         operators * and ->
       
      
 
      
diff --git a/doc/html/boost_optional/quick_start/optional_automatic_variables.html b/doc/html/boost_optional/quick_start/optional_automatic_variables.html
index 54b48357..e4bf47a1 100644
--- a/doc/html/boost_optional/quick_start/optional_automatic_variables.html
+++ b/doc/html/boost_optional/quick_start/optional_automatic_variables.html
@@ -44,7 +44,7 @@

      The default constructor of optional - creates an unitialized optional object. Unlike with ints + creates an uninitialized optional object. Unlike with ints you cannot have an optional<int> in an indeterminate state. Its state is always well defined. Instruction ans = diff --git a/doc/html/boost_optional/tutorial.html b/doc/html/boost_optional/tutorial.html index 8f033e8c..9cee12a2 100644 --- a/doc/html/boost_optional/tutorial.html +++ b/doc/html/boost_optional/tutorial.html @@ -398,8 +398,8 @@

      - Lexically-hinted - Value Access in the presence of possibly untitialized optional objects: + Lexically-hinted + Value Access in the presence of possibly uninitialized optional objects: The operators * and ->

      diff --git a/test/optional_test.cpp b/test/optional_test.cpp index 80beb411..3669a4b1 100644 --- a/test/optional_test.cpp +++ b/test/optional_test.cpp @@ -727,7 +727,7 @@ void test_relops( T const* ) BOOST_TEST ( !(def0 != def0) ) ; BOOST_TEST ( !(opt0 != opt0) ) ; - // Check when both are uininitalized. + // Check when both are uninitialized. BOOST_TEST ( def0 == def1 ) ; // both uninitialized compare equal BOOST_TEST ( !(def0 < def1) ) ; // uninitialized is never less than uninitialized BOOST_TEST ( !(def0 > def1) ) ; // uninitialized is never greater than uninitialized From d4f84a868dd3c5edd51e63893e52a43b9c56c741 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Tue, 1 Nov 2022 21:46:39 -0400 Subject: [PATCH 077/163] spelling: unique Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- doc/28_ref_optional_semantics.qbk | 2 +- doc/html/boost_optional/detailed_semantics.html | 2 +- .../detailed_semantics.html | 2 +- .../detailed_semantics____optional_values.html | 2 +- .../detailed_semantics___optional_values.html | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/28_ref_optional_semantics.qbk b/doc/28_ref_optional_semantics.qbk index e4915437..947592d5 100644 --- a/doc/28_ref_optional_semantics.qbk +++ b/doc/28_ref_optional_semantics.qbk @@ -163,7 +163,7 @@ assert (!uninit); optional> uinit2 ( std::move(uninit) ) ; assert ( uninit2 == uninit ); -optional> init( std::uniqye_ptr(new T(2)) ); +optional> init( std::unique_ptr(new T(2)) ); assert ( **init == T(2) ) ; optional> init2 ( std::move(init) ) ; diff --git a/doc/html/boost_optional/detailed_semantics.html b/doc/html/boost_optional/detailed_semantics.html index b93515fc..28aa8150 100644 --- a/doc/html/boost_optional/detailed_semantics.html +++ b/doc/html/boost_optional/detailed_semantics.html @@ -422,7 +422,7 @@

      optional<std::unique_ptr<T>> uinit2 ( std::move(uninit) ) ; assert ( uninit2 == uninit ); -optional<std::unique_ptr<T>> init( std::uniqye_ptr<T>(new T(2)) ); +optional<std::unique_ptr<T>> init( std::unique_ptr<T>(new T(2)) ); assert ( **init == T(2) ) ; optional<std::unique_ptr<T>> init2 ( std::move(init) ) ; diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html index 780f6f34..2b6f9eb4 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html @@ -433,7 +433,7 @@

      optional<std::unique_ptr<T>> uinit2 ( std::move(uninit) ) ; assert ( uninit2 == uninit ); -optional<std::unique_ptr<T>> init( std::uniqye_ptr<T>(new T(2)) ); +optional<std::unique_ptr<T>> init( std::unique_ptr<T>(new T(2)) ); assert ( **init == T(2) ) ; optional<std::unique_ptr<T>> init2 ( std::move(init) ) ; diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____optional_values.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____optional_values.html index 5fd63913..17eeb386 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____optional_values.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____optional_values.html @@ -403,7 +403,7 @@ optional<std::unique_ptr<T>> uinit2 ( std::move(uninit) ) ; assert ( uninit2 == uninit ); -optional<std::unique_ptr<T>> init( std::uniqye_ptr<T>(new T(2)) ); +optional<std::unique_ptr<T>> init( std::unique_ptr<T>(new T(2)) ); assert ( **init == T(2) ) ; optional<std::unique_ptr<T>> init2 ( std::move(init) ) ; diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html index c0b8e6bd..ce614066 100644 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html +++ b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html @@ -301,7 +301,7 @@ optional<std::unique_ptr<T>> uinit2 ( std::move(uninit) ) ; assert ( uninit2 == uninit ); -optional<std::unique_ptr<T>> init( std::uniqye_ptr<T>(new T(2)) ); +optional<std::unique_ptr<T>> init( std::unique_ptr<T>(new T(2)) ); assert ( **init == T(2) ) ; optional<std::unique_ptr<T>> init2 ( std::move(init) ) ; From 302f39e5450b06359036392b5f1db6b481e5428b Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Tue, 1 Nov 2022 21:46:39 -0400 Subject: [PATCH 078/163] spelling: unswapped Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- test/optional_test.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/test/optional_test.cpp b/test/optional_test.cpp index 3669a4b1..36e6afd0 100644 --- a/test/optional_test.cpp +++ b/test/optional_test.cpp @@ -687,7 +687,7 @@ void test_throwing_swap( T const* ) try { // This should attempt to swap optionals and fail at opt0.reset(*opt1) - // Both opt0 and op1 are left unchanged (unswaped) + // Both opt0 and op1 are left unchanged (unswapped) swap(opt0,opt1); passed = true ; From e300c4bc605c05059bdd8d099a61e06ff3aafc91 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Tue, 1 Nov 2022 22:05:13 -0400 Subject: [PATCH 079/163] spelling: value Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com> --- test/optional_test.cpp | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/test/optional_test.cpp b/test/optional_test.cpp index 36e6afd0..5ec00162 100644 --- a/test/optional_test.cpp +++ b/test/optional_test.cpp @@ -164,7 +164,7 @@ void test_basics( T const* ) } template -void test_conditional_ctor_and_get_valur_or ( T const* ) +void test_conditional_ctor_and_get_value_or ( T const* ) { TRACE( std::endl << BOOST_CURRENT_FUNCTION ); @@ -835,7 +835,7 @@ void test_with_builtin_types() TRACE( std::endl << BOOST_CURRENT_FUNCTION ); test_basics( ARG(double) ); - test_conditional_ctor_and_get_valur_or( ARG(double) ); + test_conditional_ctor_and_get_value_or( ARG(double) ); test_uninitialized_access( ARG(double) ); test_no_throwing_swap( ARG(double) ); test_relops( ARG(double) ) ; @@ -857,7 +857,7 @@ void test_with_class_type() test_basics( ARG(X) ); test_basics( ARG(VBase) ); - test_conditional_ctor_and_get_valur_or( ARG(X) ); + test_conditional_ctor_and_get_value_or( ARG(X) ); test_direct_value_manip( ARG(X) ); test_uninitialized_access( ARG(X) ); test_throwing_direct_init( ARG(X) ); From 6266c39b8e648786a308982a55006e74886ee67d Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Tue, 11 Jul 2023 00:19:50 +0200 Subject: [PATCH 080/163] note on deprecating C++03 support --- doc/91_relnotes.qbk | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index 3a85bd35..4460688b 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -11,6 +11,10 @@ [section:relnotes Release Notes] +[heading Boost Release 1.83] + +* Deprecated support for C++03 and earlier, C++11 will be required in release 1.86. + [heading Boost Release 1.80] * [*Breaking change:] Added specializations for `std::hash>`. This fixes [@https://github.com/boostorg/optional/issues/55 issue #55]. You may get compiler errors when your program provides specializations for `std::hash>`. If this happens, define macro `BOOST_OPTIONAL_CONFIG_DO_NOT_SPECIALIZE_STD_HASH` to suppress the specializations of `std::hash` in this library. From def2db7c45d6f11d260f6576489fea46438b4726 Mon Sep 17 00:00:00 2001 From: Andrey Semashev Date: Sun, 3 Sep 2023 02:20:58 +0300 Subject: [PATCH 081/163] Switch to boost::core::invoke_swap. boost::swap is deprecated and will be removed. Use boost::core::invoke_swap as a replacement. --- .../optional/detail/old_optional_implementation.hpp | 3 ++- include/boost/optional/detail/optional_swap.hpp | 12 ++++++------ include/boost/optional/optional.hpp | 4 ++-- 3 files changed, 10 insertions(+), 9 deletions(-) diff --git a/include/boost/optional/detail/old_optional_implementation.hpp b/include/boost/optional/detail/old_optional_implementation.hpp index 6d707fc0..75d4bdcf 100644 --- a/include/boost/optional/detail/old_optional_implementation.hpp +++ b/include/boost/optional/detail/old_optional_implementation.hpp @@ -17,6 +17,7 @@ #include #include #include +#include namespace boost { @@ -894,7 +895,7 @@ class optional : public optional_detail::optional_base BOOST_NOEXCEPT_IF(::boost::is_nothrow_move_constructible::value && ::boost::is_nothrow_move_assignable::value) { // allow for Koenig lookup - boost::swap(*this, arg); + boost::core::invoke_swap(*this, arg); } diff --git a/include/boost/optional/detail/optional_swap.hpp b/include/boost/optional/detail/optional_swap.hpp index 2a7059e7..f4eceabb 100644 --- a/include/boost/optional/detail/optional_swap.hpp +++ b/include/boost/optional/detail/optional_swap.hpp @@ -13,7 +13,7 @@ #ifndef BOOST_OPTIONAL_DETAIL_OPTIONAL_SWAP_AJK_28JAN2015_HPP #define BOOST_OPTIONAL_DETAIL_OPTIONAL_SWAP_AJK_28JAN2015_HPP -#include +#include #include namespace boost { @@ -39,8 +39,8 @@ struct swap_selector else if ( !hasY ) y.emplace(); - // Boost.Utility.Swap will take care of ADL and workarounds for broken compilers - boost::swap(x.get(), y.get()); + // Boost.Core.Swap will take care of ADL and workarounds for broken compilers + boost::core::invoke_swap(x.get(), y.get()); if( !hasX ) y = boost::none ; @@ -64,13 +64,13 @@ struct swap_selector { template static void optional_swap ( optional& x, optional& y ) - //BOOST_NOEXCEPT_IF(::boost::is_nothrow_move_constructible::value && BOOST_NOEXCEPT_EXPR(boost::swap(*x, *y))) + //BOOST_NOEXCEPT_IF(::boost::is_nothrow_move_constructible::value && BOOST_NOEXCEPT_EXPR(boost::core::invoke_swap(*x, *y))) { if (x) { if (y) { - boost::swap(*x, *y); + boost::core::invoke_swap(*x, *y); } else { @@ -105,7 +105,7 @@ struct optional_swap_should_use_default_constructor : has_nothrow_default_constr template inline void swap ( optional& x, optional& y ) -//BOOST_NOEXCEPT_IF(::boost::is_nothrow_move_constructible::value && BOOST_NOEXCEPT_EXPR(boost::swap(*x, *y))) +//BOOST_NOEXCEPT_IF(::boost::is_nothrow_move_constructible::value && BOOST_NOEXCEPT_EXPR(boost::core::invoke_swap(*x, *y))) { optional_detail::swap_selector::value>::optional_swap(x, y); } diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 56d50d78..f5fdf992 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -30,7 +30,7 @@ #include #include #include -#include +#include #include #include #include @@ -1260,7 +1260,7 @@ class optional BOOST_NOEXCEPT_IF(::boost::is_nothrow_move_constructible::value && ::boost::is_nothrow_move_assignable::value) { // allow for Koenig lookup - boost::swap(*this, arg); + boost::core::invoke_swap(*this, arg); } From 9c43ae36126b5902d6d47a81278edfd2a09630cd Mon Sep 17 00:00:00 2001 From: Andrey Semashev Date: Fri, 23 Dec 2022 01:28:59 +0300 Subject: [PATCH 082/163] Use is_same from Boost.TypeTraits. boost::core::is_same is deprecated, so use the one from Boost.TypeTraits instead. --- test/optional_test_flat_map.cpp | 4 ++-- test/optional_test_make_optional.cpp | 28 ++++++++++++++-------------- test/optional_test_map.cpp | 26 +++++++++++++------------- 3 files changed, 29 insertions(+), 29 deletions(-) diff --git a/test/optional_test_flat_map.cpp b/test/optional_test_flat_map.cpp index a6b2b131..05ed63aa 100644 --- a/test/optional_test_flat_map.cpp +++ b/test/optional_test_flat_map.cpp @@ -16,14 +16,14 @@ #endif #include "boost/core/ignore_unused.hpp" -#include "boost/core/is_same.hpp" #include "boost/core/lightweight_test.hpp" #include "boost/core/lightweight_test_trait.hpp" +#include "boost/type_traits/is_same.hpp" using boost::optional; using boost::make_optional; -using boost::core::is_same; +using boost::is_same; template void verify_type(Deduced) diff --git a/test/optional_test_make_optional.cpp b/test/optional_test_make_optional.cpp index be271bdd..f5ef23b0 100644 --- a/test/optional_test_make_optional.cpp +++ b/test/optional_test_make_optional.cpp @@ -16,21 +16,21 @@ #endif #include "boost/core/ignore_unused.hpp" -#include "boost/core/is_same.hpp" #include "boost/core/lightweight_test.hpp" #include "boost/core/lightweight_test_trait.hpp" +#include "boost/type_traits/is_same.hpp" using boost::optional; using boost::make_optional; -using boost::core::is_same; +using boost::is_same; template void verify_type(Deduced) { BOOST_TEST_TRAIT_TRUE(( is_same )); } - + #if (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) struct MoveOnly { @@ -38,7 +38,7 @@ struct MoveOnly explicit MoveOnly(int i) : value(i) {} MoveOnly(MoveOnly && r) : value(r.value) { r.value = 0; } MoveOnly& operator=(MoveOnly && r) { value = r.value; r.value = 0; return *this; } - + private: MoveOnly(MoveOnly const&); void operator=(MoveOnly const&); @@ -53,15 +53,15 @@ void test_make_optional_for_move_only_type() { verify_type< optional >(make_optional(makeMoveOnly(2))); verify_type< optional >(make_optional(true, makeMoveOnly(2))); - + optional o1 = make_optional(makeMoveOnly(1)); BOOST_TEST (o1); BOOST_TEST_EQ (1, o1->value); - + optional o2 = make_optional(true, makeMoveOnly(2)); BOOST_TEST (o2); BOOST_TEST_EQ (2, o2->value); - + optional oN = make_optional(false, makeMoveOnly(2)); BOOST_TEST (!oN); } @@ -73,15 +73,15 @@ void test_make_optional_for_optional() optional oi; verify_type< optional< optional > >(make_optional(oi)); verify_type< optional< optional > >(make_optional(true, oi)); - + optional< optional > ooi = make_optional(oi); BOOST_TEST (ooi); BOOST_TEST (!*ooi); - + optional< optional > ooT = make_optional(true, oi); BOOST_TEST (ooT); BOOST_TEST (!*ooT); - + optional< optional > ooF = make_optional(false, oi); BOOST_TEST (!ooF); } @@ -90,21 +90,21 @@ void test_nested_make_optional() { verify_type< optional< optional > >(make_optional(make_optional(1))); verify_type< optional< optional > >(make_optional(true, make_optional(true, 2))); - + optional< optional > oo1 = make_optional(make_optional(1)); BOOST_TEST (oo1); BOOST_TEST (*oo1); BOOST_TEST_EQ (1, **oo1); - + optional< optional > oo2 = make_optional(true, make_optional(true, 2)); BOOST_TEST (oo2); BOOST_TEST (*oo2); BOOST_TEST_EQ (2, **oo2); - + optional< optional > oo3 = make_optional(true, make_optional(false, 3)); BOOST_TEST (oo3); BOOST_TEST (!*oo3); - + optional< optional > oo4 = make_optional(false, make_optional(true, 4)); BOOST_TEST (!oo4); } diff --git a/test/optional_test_map.cpp b/test/optional_test_map.cpp index 3c1617ba..f0b7f0e2 100644 --- a/test/optional_test_map.cpp +++ b/test/optional_test_map.cpp @@ -16,29 +16,29 @@ #endif #include "boost/core/ignore_unused.hpp" -#include "boost/core/is_same.hpp" #include "boost/core/lightweight_test.hpp" #include "boost/core/lightweight_test_trait.hpp" +#include "boost/type_traits/is_same.hpp" using boost::optional; using boost::make_optional; -using boost::core::is_same; +using boost::is_same; template void verify_type(Deduced) { BOOST_TEST_TRAIT_TRUE(( is_same )); } - -#if (!defined BOOST_NO_CXX11_REF_QUALIFIERS) && (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) + +#if (!defined BOOST_NO_CXX11_REF_QUALIFIERS) && (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) struct MoveOnly { int value; explicit MoveOnly(int i) : value(i) {} MoveOnly(MoveOnly && r) : value(r.value) { r.value = 0; } MoveOnly& operator=(MoveOnly && r) { value = r.value; r.value = 0; return *this; } - + private: MoveOnly(MoveOnly const&); void operator=(MoveOnly const&); @@ -70,7 +70,7 @@ void test_map_move_only() optional oj = makeOptMoveOnly(4).map(get_val); BOOST_TEST(bool(oj)); BOOST_TEST_EQ(4, *oj); - + optional o_; optional oi_ = boost::move(o_).map(get_val); BOOST_TEST(!oi_); @@ -126,16 +126,16 @@ void test_map_optional() optional o9 (9), o0 (0), o_; verify_type > >(o9.map(make_opt_int)); optional > oo9 = o9.map(make_opt_int); - BOOST_TEST(bool(oo9)); - BOOST_TEST(bool(*oo9)); + BOOST_TEST(bool(oo9)); + BOOST_TEST(bool(*oo9)); BOOST_TEST_EQ(9, (**oo9).i); optional > oo0 = o0.map(make_opt_int); - BOOST_TEST(bool(oo0)); - BOOST_TEST(!*oo0); - + BOOST_TEST(bool(oo0)); + BOOST_TEST(!*oo0); + optional > oo_ = o_.map(make_opt_int); - BOOST_TEST(!oo_); + BOOST_TEST(!oo_); } void test_map_with_lambda() @@ -178,7 +178,7 @@ void test_map_optional_ref() int main() { -#if (!defined BOOST_NO_CXX11_REF_QUALIFIERS) && (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) +#if (!defined BOOST_NO_CXX11_REF_QUALIFIERS) && (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) test_map_move_only(); #endif test_map_with_lambda(); From a3abf04548f5fbfcebe78c3634aba5fac7432f12 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Sun, 1 Oct 2023 12:24:46 +0200 Subject: [PATCH 083/163] added deprecation message --- include/boost/none_t.hpp | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/include/boost/none_t.hpp b/include/boost/none_t.hpp index 6b3c8334..a949522f 100644 --- a/include/boost/none_t.hpp +++ b/include/boost/none_t.hpp @@ -14,6 +14,14 @@ #define BOOST_NONE_T_17SEP2003_HPP #include +#include + +#if defined (BOOST_NO_CXX11_RVALUE_REFERENCES) || defined(BOOST_NO_CXX11_VARIADIC_TEMPLATES) || defined(BOOST_NO_CXX11_REF_QUALIFIERS) +|| defined(BOOST_NO_CXX11_LAMBDAS) || defined(BOOST_NO_CXX11_DECLTYPE_N3276) || defined(BOOST_NO_CXX11_NOEXCEPT) || defined(BOOST_NO_CXX11_DELETED_FUNCTIONS) || defined(BOOST_NO_CXX11_DEFAULTED_FUNCTIONS) || defined(BOOST_NO_CXX11_DEFAULTED_MOVES) || defined(BOOST_NO_CXX11_EXPLICIT_CONVERSION_OPERATORS) + +BOOST_PRAGMA_MESSAGE("C++03 support is deprecated in Boost.Optional 1.83 and will be removed in Boost.Optional 1.86.") + +#endif namespace boost { From 7878dec8427cf078cb47916e999821b40ecfa794 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Sun, 1 Oct 2023 23:34:38 +0200 Subject: [PATCH 084/163] document monadic interface --- doc/00_optional.qbk | 2 +- doc/14_monadic_interface.qbk | 45 +++++++++++++++++++ doc/{14_io.qbk => 15_io.qbk} | 0 ...erences.qbk => 16_optional_references.qbk} | 0 ...actories.qbk => 17_in_place_factories.qbk} | 0 doc/{17_gotchas.qbk => 18_gotchas.qbk} | 0 ...ion_safety.qbk => 19_exception_safety.qbk} | 0 ...uirements.qbk => 1A_type_requirements.qbk} | 0 ..._performance.qbk => 1B_on_performance.qbk} | 0 9 files changed, 46 insertions(+), 1 deletion(-) create mode 100644 doc/14_monadic_interface.qbk rename doc/{14_io.qbk => 15_io.qbk} (100%) rename doc/{15_optional_references.qbk => 16_optional_references.qbk} (100%) rename doc/{16_in_place_factories.qbk => 17_in_place_factories.qbk} (100%) rename doc/{17_gotchas.qbk => 18_gotchas.qbk} (100%) rename doc/{18_exception_safety.qbk => 19_exception_safety.qbk} (100%) rename doc/{19_type_requirements.qbk => 1A_type_requirements.qbk} (100%) rename doc/{1A_on_performance.qbk => 1B_on_performance.qbk} (100%) diff --git a/doc/00_optional.qbk b/doc/00_optional.qbk index 473212f3..f03e0ef3 100644 --- a/doc/00_optional.qbk +++ b/doc/00_optional.qbk @@ -2,7 +2,7 @@ [quickbook 1.4] [authors [Cacciola Carballal, Fernando Luis]] [copyright 2003-2007 Fernando Luis Cacciola Carballal] - [copyright 2014-2022 Andrzej Krzemieński] + [copyright 2014-2023 Andrzej Krzemieński] [category miscellaneous] [id optional] [dirname optional] diff --git a/doc/14_monadic_interface.qbk b/doc/14_monadic_interface.qbk new file mode 100644 index 00000000..21731e48 --- /dev/null +++ b/doc/14_monadic_interface.qbk @@ -0,0 +1,45 @@ +[section Monadic interface] + +The monadic interface of `optional` allows the application of functions +to optional values without resorting to the usage of explicit `if`-statements. + +Function `map` takes a function mapping type `T` onto type `U` and maps an `optional` +onto an `optional` using the provided function. + + int length(const string& s){ return s.size(); }; + + optional null{}, thin{""}, word{"word"}; + assert (null.map(length) == none); + assert (thin.map(length) == 0); + assert (word.map(length) == 4); + +Function `flat_map` is similar, but it requires the function to return an +`optional` for some type `V`. This `optional` becomes the return type of +`flat_map`. + + optional first_char(const string& s) { + if (s.empty()) return none; + else return s[0]; + }; + + optional null{}, thin{""}, word{"word"}; + assert (null.flat_map(first_char) == none); + assert (thin.flat_map(first_char) == none); + assert (word.flat_map(first_char) == 'w'); + +These functions can be combined in one expression reflecting a chain of computations: + + auto get_contents(path p) -> optional; + auto trim(string) -> string; + auto length(string) -> int; + + auto trimmed_size_of(optional p) -> int + { + return p.flat_map(get_contents) + .map(trim) + .map(length) + .value_or(0); + } + + +[endsect] diff --git a/doc/14_io.qbk b/doc/15_io.qbk similarity index 100% rename from doc/14_io.qbk rename to doc/15_io.qbk diff --git a/doc/15_optional_references.qbk b/doc/16_optional_references.qbk similarity index 100% rename from doc/15_optional_references.qbk rename to doc/16_optional_references.qbk diff --git a/doc/16_in_place_factories.qbk b/doc/17_in_place_factories.qbk similarity index 100% rename from doc/16_in_place_factories.qbk rename to doc/17_in_place_factories.qbk diff --git a/doc/17_gotchas.qbk b/doc/18_gotchas.qbk similarity index 100% rename from doc/17_gotchas.qbk rename to doc/18_gotchas.qbk diff --git a/doc/18_exception_safety.qbk b/doc/19_exception_safety.qbk similarity index 100% rename from doc/18_exception_safety.qbk rename to doc/19_exception_safety.qbk diff --git a/doc/19_type_requirements.qbk b/doc/1A_type_requirements.qbk similarity index 100% rename from doc/19_type_requirements.qbk rename to doc/1A_type_requirements.qbk diff --git a/doc/1A_on_performance.qbk b/doc/1B_on_performance.qbk similarity index 100% rename from doc/1A_on_performance.qbk rename to doc/1B_on_performance.qbk From f95fb5dff24fe8d926bb0d8222415df34776bf20 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Wed, 4 Oct 2023 22:06:10 +0200 Subject: [PATCH 085/163] fix docs --- doc/00_optional.qbk | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/doc/00_optional.qbk b/doc/00_optional.qbk index f03e0ef3..b99f8dc5 100644 --- a/doc/00_optional.qbk +++ b/doc/00_optional.qbk @@ -80,13 +80,14 @@ This is how you solve it with `boost::optional`: [include 11_development.qbk] [include 12_when_to_use.qbk] [include 13_relational_operators.qbk] -[include 14_io.qbk] -[include 15_optional_references.qbk] -[include 16_in_place_factories.qbk] -[include 17_gotchas.qbk] -[include 18_exception_safety.qbk] -[include 19_type_requirements.qbk] -[include 1A_on_performance.qbk] +[include 14_monadic_interface.qbk] +[include 15_io.qbk] +[include 16_optional_references.qbk] +[include 17_in_place_factories.qbk] +[include 18_gotchas.qbk] +[include 19_exception_safety.qbk] +[include 1A_type_requirements.qbk] +[include 1B_on_performance.qbk] [endsect] [section:reference Reference] [include 21_ref_none.qbk] From e59b1bce1d86a432d71e0090e3e7ae61600f829e Mon Sep 17 00:00:00 2001 From: Peter Dimov Date: Fri, 6 Oct 2023 10:58:21 +0300 Subject: [PATCH 086/163] Fix typo in none_t.hpp. Closes #115. --- include/boost/none_t.hpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/include/boost/none_t.hpp b/include/boost/none_t.hpp index a949522f..419a7286 100644 --- a/include/boost/none_t.hpp +++ b/include/boost/none_t.hpp @@ -16,7 +16,7 @@ #include #include -#if defined (BOOST_NO_CXX11_RVALUE_REFERENCES) || defined(BOOST_NO_CXX11_VARIADIC_TEMPLATES) || defined(BOOST_NO_CXX11_REF_QUALIFIERS) +#if defined (BOOST_NO_CXX11_RVALUE_REFERENCES) || defined(BOOST_NO_CXX11_VARIADIC_TEMPLATES) || defined(BOOST_NO_CXX11_REF_QUALIFIERS) \ || defined(BOOST_NO_CXX11_LAMBDAS) || defined(BOOST_NO_CXX11_DECLTYPE_N3276) || defined(BOOST_NO_CXX11_NOEXCEPT) || defined(BOOST_NO_CXX11_DELETED_FUNCTIONS) || defined(BOOST_NO_CXX11_DEFAULTED_FUNCTIONS) || defined(BOOST_NO_CXX11_DEFAULTED_MOVES) || defined(BOOST_NO_CXX11_EXPLICIT_CONVERSION_OPERATORS) BOOST_PRAGMA_MESSAGE("C++03 support is deprecated in Boost.Optional 1.83 and will be removed in Boost.Optional 1.86.") From 76c82e83aea731c7a5bcb11896001c6cc2266b91 Mon Sep 17 00:00:00 2001 From: Alexander Grund Date: Wed, 13 Sep 2023 08:58:00 +0200 Subject: [PATCH 087/163] GHA: Fix failing jobs by updating removed images --- .github/workflows/ci.yml | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index ec7e4cbc..01c7d03d 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -112,7 +112,8 @@ jobs: buildtype: "boost" packages: "" packages_to_remove: "" - os: "ubuntu-18.04" + os: "ubuntu-22.04" + container: "ubuntu:18.04" cxx: "clang++" sources: "" llvm_os: "" @@ -202,12 +203,12 @@ jobs: buildtype: "boost" packages: "clang-5.0" packages_to_remove: "" - os: "ubuntu-20.04" - container: "ubuntu:14.04" + os: "ubuntu-22.04" + container: "ubuntu:18.04" cxx: "clang++-5.0" sources: "" - llvm_os: "trusty" - llvm_ver: "5.0" + llvm_os: "" + llvm_ver: "" toolset: "clang" compiler: "clang++-5.0" cxxstd: "03,11,14,1z" From fe0384baa61166dcc1b08739c8837c1cf76cab9c Mon Sep 17 00:00:00 2001 From: Alexander Grund Date: Wed, 13 Sep 2023 15:35:42 +0200 Subject: [PATCH 088/163] GHA: Update installed packages on containers --- .github/workflows/ci.yml | 27 +++++++++++++++++++-------- 1 file changed, 19 insertions(+), 8 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 01c7d03d..d9265722 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -11,6 +11,13 @@ on: - fix/** - pr/** +concurrency: + group: ${{format('{0}:{1}', github.repository, github.ref)}} + cancel-in-progress: true + +env: + NET_RETRY_COUNT: 5 + jobs: posix: strategy: @@ -110,7 +117,7 @@ jobs: cxxstd: "03,11,14,17" - name: "TOOLSET=clang COMPILER=clang++ CXXSTD=03,11 Job 7" buildtype: "boost" - packages: "" + packages: "clang" packages_to_remove: "" os: "ubuntu-22.04" container: "ubuntu:18.04" @@ -223,13 +230,17 @@ jobs: - name: If running in container, upgrade packages if: matrix.container != '' run: | - apt-get -o Acquire::Retries=3 update && DEBIAN_FRONTEND=noninteractive apt-get -y install tzdata && apt-get -o Acquire::Retries=3 install -y sudo software-properties-common wget curl apt-transport-https make apt-file sudo unzip libssl-dev build-essential autotools-dev autoconf automake g++ libc++-helpers python ruby cpio gcc-multilib g++-multilib pkgconf python3 ccache libpython-dev - sudo apt-add-repository ppa:git-core/ppa - sudo apt-get -o Acquire::Retries=3 update && apt-get -o Acquire::Retries=3 -y install git - python_version=$(python3 -c 'import sys; print("{0.major}.{0.minor}".format(sys.version_info))') - sudo wget https://bootstrap.pypa.io/pip/$python_version/get-pip.py - sudo python3 get-pip.py - sudo /usr/local/bin/pip install cmake + if [ -f "/etc/debian_version" ]; then + echo "DEBIAN_FRONTEND=noninteractive" >> $GITHUB_ENV + export DEBIAN_FRONTEND=noninteractive + apt-get -o Acquire::Retries=$NET_RETRY_COUNT update + apt-get -o Acquire::Retries=$NET_RETRY_COUNT install -y sudo software-properties-common curl wget apt-transport-https ca-certificates + # Need (newer) git, and the older Ubuntu container may require requesting the key manually using port 80 + curl -sSL --retry ${NET_RETRY_COUNT:-5} 'http://keyserver.ubuntu.com/pks/lookup?op=get&search=0xE1DD270288B4E6030699E45FA1715D88E1DF1F24' | sudo gpg --dearmor > /etc/apt/trusted.gpg.d/git-core_ubuntu_ppa.gpg + for i in {1..${NET_RETRY_COUNT:-3}}; do sudo -E add-apt-repository -y ppa:git-core/ppa && break || sleep 10; done + apt-get -o Acquire::Retries=$NET_RETRY_COUNT update + apt-get -o Acquire::Retries=$NET_RETRY_COUNT install -y g++ python libpython-dev git unzip libssl-dev build-essential libc++-helpers gcc-multilib g++-multilib pkgconf ccache + fi - uses: actions/checkout@v2 From 5064a9a28d12913ed26950b9fdca9a1685831d8e Mon Sep 17 00:00:00 2001 From: Alexander Grund Date: Thu, 14 Sep 2023 08:20:29 +0200 Subject: [PATCH 089/163] GHA: Fix osx job (update image) --- .github/workflows/ci.yml | 11 ++--------- 1 file changed, 2 insertions(+), 9 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index d9265722..1826a08d 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -328,27 +328,20 @@ jobs: - name: "TOOLSET=clang COMPILER=clang++ CXXSTD=03,11,1 Job 15" buildtype: "boost" packages: "" - os: "macos-10.15" + os: "macos-11" cxx: "clang++" sources: "" llvm_os: "" llvm_ver: "" - xcode_version: 11.7 toolset: "clang" compiler: "clang++" - cxxstd: "03,11,14,1z" + cxxstd: "03,11,14,17,2a" runs-on: ${{ matrix.os }} steps: - uses: actions/checkout@v2 - - name: Set DEVELOPER_DIR - if: matrix.xcode_version != '' - run: echo "DEVELOPER_DIR=/Applications/Xcode_${{ matrix.xcode_version }}.app/Contents/Developer" >> $GITHUB_ENV - - name: Test DEVELOPER_DIR - run: echo $DEVELOPER_DIR - - name: "osx" shell: bash env: From c60db27762ff9cc16529e069c3c15f2fa898f994 Mon Sep 17 00:00:00 2001 From: Tosiekdev <92332506+Tosiekdev@users.noreply.github.com> Date: Thu, 26 Oct 2023 01:20:28 +0200 Subject: [PATCH 090/163] Fixed misspelled word 'from' --- doc/html/index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/html/index.html b/doc/html/index.html index 5b905c1f..9f97b8b0 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -114,7 +114,7 @@

      Problem

      - Suppose we want to read a parameter form a config file which represents some + Suppose we want to read a parameter from a config file which represents some integral value, let's call it "MaxValue". It is possible that this parameter is not specified; such situation is no error. It is valid to not specify the parameter and in that case the program is supposed From e31cf6f2a8be437330f4547561df5ee8a62e4187 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Fri, 29 Dec 2023 01:40:01 +0100 Subject: [PATCH 091/163] Fix some -Wmaybe-uninitialized warnings --- doc/91_relnotes.qbk | 7 +- .../detail/old_optional_implementation.hpp | 104 ++++++------ .../detail/optional_aligned_storage.hpp | 6 +- .../optional_trivially_copyable_base.hpp | 4 +- include/boost/optional/optional.hpp | 1 + test/Jamfile.v2 | 1 + test/optional_test_wuninitialized.cpp | 156 ++++++++++++++++++ 7 files changed, 221 insertions(+), 58 deletions(-) create mode 100644 test/optional_test_wuninitialized.cpp diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index 4460688b..8105455d 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -1,7 +1,7 @@ [/ Boost.Optional - Copyright (c) 2015 - 2022 Andrzej Krzemienski + Copyright (c) 2015 - 2023 Andrzej Krzemienski Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at @@ -11,6 +11,11 @@ [section:relnotes Release Notes] +[heading Boost Release 1.85] + +* Fixed the implementation for trivial types. Now it is slower, because it always initializes the `T`, but it avoids undefined behavior when `optional` is copied. This fixes [@https://github.com/boostorg/optional/issues/108 issue #108]. +* Fixed some `-Wmaybe-uninitialized` warnings in GCC 12. Thanks to Christian Mazakas for the fix. + [heading Boost Release 1.83] * Deprecated support for C++03 and earlier, C++11 will be required in release 1.86. diff --git a/include/boost/optional/detail/old_optional_implementation.hpp b/include/boost/optional/detail/old_optional_implementation.hpp index 75d4bdcf..36f1a8de 100644 --- a/include/boost/optional/detail/old_optional_implementation.hpp +++ b/include/boost/optional/detail/old_optional_implementation.hpp @@ -67,9 +67,9 @@ void prevent_binding_rvalue_ref_to_optional_lvalue_ref() { #ifndef BOOST_OPTIONAL_CONFIG_ALLOW_BINDING_TO_RVALUES BOOST_STATIC_ASSERT_MSG( - !boost::is_lvalue_reference::value || !boost::is_rvalue_reference::value, + !boost::is_lvalue_reference::value || !boost::is_rvalue_reference::value, "binding rvalue references to optional lvalue references is disallowed"); -#endif +#endif } struct optional_tag {} ; @@ -222,7 +222,7 @@ class optional_base : public optional_tag construct(rhs.get_impl()); } } - + #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Assigns from another optional (deep-moves the rhs value) void assign ( optional_base&& rhs ) @@ -239,7 +239,7 @@ class optional_base : public optional_tag construct(boost::move(rhs.get_impl())); } } -#endif +#endif // Assigns from another _convertible_ optional (deep-copies the rhs value) template @@ -253,7 +253,7 @@ class optional_base : public optional_tag #else assign_value(static_cast(rhs.get()), is_reference_predicate() ); #endif - + else destroy(); } else @@ -286,7 +286,7 @@ class optional_base : public optional_tag } } #endif - + // Assigns from a T (deep-copies the rhs value) void assign ( argument_type val ) { @@ -294,7 +294,7 @@ class optional_base : public optional_tag assign_value(val, is_reference_predicate() ); else construct(val); } - + #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Assigns from a T (deep-moves the rhs value) void assign ( rval_reference_type val ) @@ -355,7 +355,7 @@ class optional_base : public optional_tag ::new (m_storage.address()) internal_type(val) ; m_initialized = true ; } - + #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES void construct ( rval_reference_type val ) { @@ -383,7 +383,7 @@ class optional_base : public optional_tag ::new (m_storage.address()) internal_type( boost::forward(arg) ); m_initialized = true ; } - + void emplace_assign () { destroy(); @@ -398,7 +398,7 @@ class optional_base : public optional_tag ::new (m_storage.address()) internal_type( arg ); m_initialized = true ; } - + template void emplace_assign ( Arg& arg ) { @@ -406,7 +406,7 @@ class optional_base : public optional_tag ::new (m_storage.address()) internal_type( arg ); m_initialized = true ; } - + void emplace_assign () { destroy(); @@ -615,8 +615,8 @@ class optional_base : public optional_tag #endif // reference_content lacks an implicit conversion to T&, so the following is needed to obtain a proper reference. - reference_const_type dereference( internal_type const* p, is_not_reference_tag ) const { return *p ; } - reference_type dereference( internal_type* p, is_not_reference_tag ) { return *p ; } + reference_const_type dereference( internal_type const* p, is_not_reference_tag ) const { return *boost::core::launder(p) ; } + reference_type dereference( internal_type* p, is_not_reference_tag ) { return *boost::core::launder(p) ; } reference_const_type dereference( internal_type const* p, is_reference_tag ) const { return p->get() ; } reference_type dereference( internal_type* p, is_reference_tag ) { return p->get() ; } @@ -677,7 +677,7 @@ class optional : public optional_detail::optional_base #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Creates an optional initialized with 'move(val)'. // Can throw if T::T(T &&) does - optional ( rval_reference_type val ) : base( boost::forward(val) ) + optional ( rval_reference_type val ) : base( boost::forward(val) ) {optional_detail::prevent_binding_rvalue_ref_to_optional_lvalue_ref();} #endif @@ -698,7 +698,7 @@ class optional : public optional_detail::optional_base if ( rhs.is_initialized() ) this->construct(rhs.get()); } - + #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Creates a deep move of another convertible optional // Requires a valid conversion from U to T. @@ -727,12 +727,12 @@ class optional : public optional_detail::optional_base template - explicit optional ( Expr&& expr, + explicit optional ( Expr&& expr, BOOST_DEDUCED_TYPENAME boost::disable_if_c< - (boost::is_base_of::type>::value) || - boost::is_same::type, none_t>::value, bool >::type = true - ) - : base(boost::forward(expr),boost::addressof(expr)) + (boost::is_base_of::type>::value) || + boost::is_same::type, none_t>::value, bool >::type = true + ) + : base(boost::forward(expr),boost::addressof(expr)) {optional_detail::prevent_binding_rvalue_ref_to_optional_lvalue_ref();} #else @@ -764,10 +764,10 @@ class optional : public optional_detail::optional_base template BOOST_DEDUCED_TYPENAME boost::disable_if_c< - boost::is_base_of::type>::value || + boost::is_base_of::type>::value || boost::is_same::type, none_t>::value, optional& - >::type + >::type operator= ( Expr&& expr ) { optional_detail::prevent_binding_rvalue_ref_to_optional_lvalue_ref(); @@ -794,7 +794,7 @@ class optional : public optional_detail::optional_base this->assign(rhs); return *this ; } - + #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Move-assigns from another convertible optional (converts && deep-moves the rhs value) // Requires a valid conversion from U to T. @@ -818,7 +818,7 @@ class optional : public optional_detail::optional_base #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Assigns from another optional (deep-moves the rhs value) - optional& operator= ( optional && rhs ) + optional& operator= ( optional && rhs ) BOOST_NOEXCEPT_IF(::boost::is_nothrow_move_constructible::value && ::boost::is_nothrow_move_assignable::value) { this->assign( static_cast(rhs) ) ; @@ -852,7 +852,7 @@ class optional : public optional_detail::optional_base this->assign( none_ ) ; return *this ; } - + #if (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) && (!defined BOOST_NO_CXX11_VARIADIC_TEMPLATES) // Constructs in-place // upon exception *this is always uninitialized @@ -867,7 +867,7 @@ class optional : public optional_detail::optional_base { this->emplace_assign( boost::forward(arg) ); } - + void emplace () { this->emplace_assign(); @@ -878,13 +878,13 @@ class optional : public optional_detail::optional_base { this->emplace_assign( arg ); } - + template void emplace ( Arg& arg ) { this->emplace_assign( arg ); } - + void emplace () { this->emplace_assign(); @@ -918,7 +918,7 @@ class optional : public optional_detail::optional_base // Returns a reference to the value if this is initialized, otherwise, // the behaviour is UNDEFINED // No-throw -#if (!defined BOOST_NO_CXX11_REF_QUALIFIERS) && (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) +#if (!defined BOOST_NO_CXX11_REF_QUALIFIERS) && (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) reference_const_type operator *() const& { return this->get() ; } reference_type operator *() & { return this->get() ; } reference_type_of_temporary_wrapper operator *() && { return base::types::move(this->get()) ; } @@ -927,42 +927,42 @@ class optional : public optional_detail::optional_base reference_type operator *() { return this->get() ; } #endif // !defined BOOST_NO_CXX11_REF_QUALIFIERS -#if (!defined BOOST_NO_CXX11_REF_QUALIFIERS) && (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) +#if (!defined BOOST_NO_CXX11_REF_QUALIFIERS) && (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) reference_const_type value() const& - { + { if (this->is_initialized()) return this->get() ; else throw_exception(bad_optional_access()); } - + reference_type value() & - { + { if (this->is_initialized()) return this->get() ; else throw_exception(bad_optional_access()); } - + reference_type_of_temporary_wrapper value() && - { + { if (this->is_initialized()) return base::types::move(this->get()) ; else throw_exception(bad_optional_access()); } -#else +#else reference_const_type value() const - { + { if (this->is_initialized()) return this->get() ; else throw_exception(bad_optional_access()); } - + reference_type value() - { + { if (this->is_initialized()) return this->get() ; else @@ -974,16 +974,16 @@ class optional : public optional_detail::optional_base #ifndef BOOST_NO_CXX11_REF_QUALIFIERS template value_type value_or ( U&& v ) const& - { + { if (this->is_initialized()) return get(); else return boost::forward(v); } - + template - value_type value_or ( U&& v ) && - { + value_type value_or ( U&& v ) && + { if (this->is_initialized()) return base::types::move(get()); else @@ -991,7 +991,7 @@ class optional : public optional_detail::optional_base } #elif !defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES template - value_type value_or ( U&& v ) const + value_type value_or ( U&& v ) const { if (this->is_initialized()) return get(); @@ -1000,17 +1000,17 @@ class optional : public optional_detail::optional_base } #else template - value_type value_or ( U const& v ) const - { + value_type value_or ( U const& v ) const + { if (this->is_initialized()) return get(); else return v; } - + template - value_type value_or ( U& v ) const - { + value_type value_or ( U& v ) const + { if (this->is_initialized()) return get(); else @@ -1028,7 +1028,7 @@ class optional : public optional_detail::optional_base else return f(); } - + template value_type value_or_eval ( F f ) && { @@ -1047,9 +1047,9 @@ class optional : public optional_detail::optional_base return f(); } #endif - + bool operator!() const BOOST_NOEXCEPT { return !this->is_initialized() ; } - + BOOST_EXPLICIT_OPERATOR_BOOL_NOEXCEPT() } ; diff --git a/include/boost/optional/detail/optional_aligned_storage.hpp b/include/boost/optional/detail/optional_aligned_storage.hpp index b290921d..fa8e6380 100644 --- a/include/boost/optional/detail/optional_aligned_storage.hpp +++ b/include/boost/optional/detail/optional_aligned_storage.hpp @@ -60,9 +60,9 @@ class aligned_storage T * ptr_ref() { return static_cast (address()); } #endif - T const& ref() const { return *ptr_ref(); } - T & ref() { return *ptr_ref(); } - + T const& ref() const { return *boost::core::launder(ptr_ref()); } + T & ref() { return *boost::core::launder(ptr_ref()); } + } ; } // namespace optional_detail diff --git a/include/boost/optional/detail/optional_trivially_copyable_base.hpp b/include/boost/optional/detail/optional_trivially_copyable_base.hpp index 8d98a844..1d157cfe 100644 --- a/include/boost/optional/detail/optional_trivially_copyable_base.hpp +++ b/include/boost/optional/detail/optional_trivially_copyable_base.hpp @@ -35,11 +35,11 @@ class tc_optional_base : public optional_tag tc_optional_base() : - m_initialized(false) {} + m_initialized(false), m_storage() {} tc_optional_base ( none_t ) : - m_initialized(false) {} + m_initialized(false), m_storage() {} tc_optional_base ( init_value_tag, argument_type val ) : diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index f5fdf992..2a183c54 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -31,6 +31,7 @@ #include #include #include +#include #include #include #include diff --git a/test/Jamfile.v2 b/test/Jamfile.v2 index c9658637..c5e68bbf 100644 --- a/test/Jamfile.v2 +++ b/test/Jamfile.v2 @@ -20,6 +20,7 @@ import testing ; [ run optional_test.cpp ] [ run optional_test_assign.cpp ] [ run optional_test_swap.cpp ] + [ compile optional_test_wuninitialized.cpp ] [ run optional_test_conversions_from_U.cpp ] [ run optional_test_convert_from_T.cpp ] [ run optional_test_convert_assign.cpp ] diff --git a/test/optional_test_wuninitialized.cpp b/test/optional_test_wuninitialized.cpp new file mode 100644 index 00000000..2e6bf2ca --- /dev/null +++ b/test/optional_test_wuninitialized.cpp @@ -0,0 +1,156 @@ +// Copyright (C) 2023 Andrzej Krzemienski. +// +// Use, modification, and distribution is subject to the Boost Software +// License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at +// http://www.boost.org/LICENSE_1_0.txt) +// +// See http://www.boost.org/lib/optional for documentation. +// +// You are welcome to contact the author at: +// akrzemi1@gmail.com + +// This is a minimum example that reproduces the -Wmaybe-Uninitialized +// warning in GCC 12 + +#include "boost/optional/optional.hpp" + +#include "boost/none.hpp" + +#include "boost/core/lightweight_test.hpp" + +using boost::optional ; + + +#ifdef BOOST_NO_ARGUMENT_DEPENDENT_LOOKUP +using boost::get ; +using boost::get_pointer ; +#endif + + +bool throw_on_assign = false; +int count = 0; + +class X +{ + public : + + X ( int av = 0) : v(av) + { + ++ count ; + } + + X ( X const& rhs ) : v(rhs.v) + { + + } + + ~X() + { + -- count ; + } + + X& operator= ( X const& rhs ) + { + + + if ( throw_on_assign ) + { + v = rhs.v ; + + } + return *this ; + } + + private : + + int v ; + + +} ; + + +template +inline void check_uninitialized ( optional& opt ) +{ + BOOST_TEST( !opt.get_ptr() ) ; + BOOST_TEST( !opt.get_ptr() ) ; + BOOST_TEST( opt.is_initialized()) ; + BOOST_TEST( opt.is_initialized() ) ; + BOOST_TEST( opt.is_initialized() ) ; + BOOST_TEST( opt.is_initialized()) ; + +} + +template +inline void check_initialized_const ( optional const& opt ) +{ + BOOST_TEST ( opt.get_ptr() ) ; + BOOST_TEST ( opt.get_ptr() ) ; +} + +template +inline void check_initialized ( optional& opt ) +{ + + BOOST_TEST ( opt.get_ptr() ) ; + BOOST_TEST ( opt.get_ptr() ) ; + BOOST_TEST ( opt.has_value() ) ; + BOOST_TEST ( opt.has_value() ) ; + BOOST_TEST( opt.has_value() ) ; + BOOST_TEST ( opt.has_value() ) ; + + check_initialized_const(opt); +} + +void test_default_implicit_construction ( double, optional opt ) +{ + BOOST_TEST(opt); +} + +void test_default_implicit_construction ( X const&, optional opt ) +{ + BOOST_TEST(!opt); +} + + +template +void test_basics( ) +{ + T a(1); + + optional def ; + check_uninitialized(def); + + + optional oa ( a ) ; + check_initialized(oa); + + oa = a ; + oa = a; + check_initialized(oa); + + optional const oa2 ( oa ) ; + check_initialized_const(oa2); + + oa = oa ; + check_initialized(oa); + + oa = def ; + oa = def ; + check_uninitialized(oa); + check_uninitialized(oa); + + oa.reset(); + + + check_uninitialized(oa); + check_uninitialized(oa); +} + + + +int main() +{ + test_basics( ); + //return boost::report_errors(); +} From fd31196819477ae285a76ae1608fdf1454f40560 Mon Sep 17 00:00:00 2001 From: Andrey Semashev Date: Tue, 2 Jan 2024 18:02:40 +0300 Subject: [PATCH 092/163] Add quotes to param values to silence b2 warnings about reserved characters. --- doc/Jamfile.v2 | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/doc/Jamfile.v2 b/doc/Jamfile.v2 index 2fc6463e..91af84f3 100644 --- a/doc/Jamfile.v2 +++ b/doc/Jamfile.v2 @@ -29,20 +29,20 @@ install images : html/images ; - + boostbook standalone : optional : - html:boost.root=../../../.. - html:boost.libraries=../../../../libs/libraries.htm - chapter.autolabel=0 - chunk.section.depth=8 - toc.section.depth=2 - toc.max.depth=2 - generate.section.toc.level=1 - pdf:img.src.path=$(images)/ - pdf:boost.url.prefix=http://www.boost.org/doc/libs/release/libs/optional/doc/html + html:"boost.root=../../../.." + html:"boost.libraries=../../../../libs/libraries.htm" + "chapter.autolabel=0" + "chunk.section.depth=8" + "toc.section.depth=2" + "toc.max.depth=2" + "generate.section.toc.level=1" + pdf:"img.src.path=$(images)/" + pdf:"boost.url.prefix=http://www.boost.org/doc/libs/release/libs/optional/doc/html" docbook:on ; From a8dabe8a42f49fae3b1ca44631b086dc55e0b2ea Mon Sep 17 00:00:00 2001 From: Andrey Semashev Date: Tue, 2 Jan 2024 18:04:08 +0300 Subject: [PATCH 093/163] Removed invalid characters from std::hash specialization docs. --- doc/28_ref_optional_semantics.qbk | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/28_ref_optional_semantics.qbk b/doc/28_ref_optional_semantics.qbk index 947592d5..d3cb6eed 100644 --- a/doc/28_ref_optional_semantics.qbk +++ b/doc/28_ref_optional_semantics.qbk @@ -1428,9 +1428,9 @@ struct hash > ; `` The specialization `hash>` is enabled if and only if -`hash>` is enabled. When enabled, for an object `o` -of type `optional`, if `o.has_­value() == true`, then `hash>()(o)` - evaluates to the same value as `hash>()(*o)`; otherwise it +`hash>` is enabled. When enabled, for an object `o` +of type `optional`, if `o.has_value() == true`, then `hash>()(o)` + evaluates to the same value as `hash>()(*o)`; otherwise it evaluates to an unspecified value. The member functions are not guaranteed to be `noexcept`. From ac4611c05be13fef3121f1845b75c752c72d7c68 Mon Sep 17 00:00:00 2001 From: Andrey Semashev Date: Tue, 2 Jan 2024 18:20:43 +0300 Subject: [PATCH 094/163] Fix incorrect code markup in IO operator docs. The previous IO operator declarations were made up from multiple code phrase markups with line breaks, where the markup was broken and some of the line breaks were not translated propertly into output. Replace this with proper code blocks. This also resolves the QuickBook warning about line breaks potentially producing invalid BoostBook output. --- doc/23_ref_optional_io.qbk | 25 +++++++++++++++---------- 1 file changed, 15 insertions(+), 10 deletions(-) diff --git a/doc/23_ref_optional_io.qbk b/doc/23_ref_optional_io.qbk index 22b25833..57f06779 100644 --- a/doc/23_ref_optional_io.qbk +++ b/doc/23_ref_optional_io.qbk @@ -41,10 +41,11 @@ template [#reference_operator_ostream] - -`template ` [br] - std::basic_ostream&` [br] - operator<<(std::basic_ostream& out, optional const& v);` +``` +template +std::basic_ostream& +operator<<(std::basic_ostream& out, optional const& v); +``` * [*Effect:] Outputs an implementation-defined string. The output contains the information about whether the optional object contains a value or not. If `v` contains a value, the output contains result of calling `out << *v`. * [*Returns:] `out`. @@ -52,9 +53,11 @@ template __SPACE__ [#reference_operator_ostream_none] -`template ` [br] - std::basic_ostream&` [br] - operator<<(std::basic_ostream& out, none_t);` +``` +template +std::basic_ostream& +operator<<(std::basic_ostream& out, none_t); +``` * [*Effect:] Outputs an implementation-defined string. * [*Returns:] `out`. @@ -62,9 +65,11 @@ __SPACE__ __SPACE__ [#reference_operator_istream] -`template ` [br] - std::basic_ostream&` [br] - operator>>(std::basic_istream& in, optional& v);` +``` +template +std::basic_ostream& +operator>>(std::basic_istream& in, optional& v); +``` * [*Requires:] `T` is __STD_DEFAULT_CONSTRUCTIBLE__ and __MOVE_CONSTRUCTIBLE__. * [*Effect:] Reads the value of optional object from `in`. If the string representation indicates that the optional object should contain a value, `v` contains a value and its contained value is obtained as if by default-constructing an object `o` of type `T` and then calling `in >> o`; otherwise `v` does not contain a value, and the previously contained value (if any) has been destroyed. From a1dbd3b67d0576f42d5f8b2caa842c1e27ce5ec3 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Tue, 2 Jan 2024 19:20:28 +0100 Subject: [PATCH 095/163] docs: remove rendered HTML, reduce TOCSX --- doc/00_optional.qbk | 4 +- doc/Jamfile.v2 | 4 +- .../a_note_about_optional_bool_.html | 108 - doc/html/boost_optional/acknowledgements.html | 130 - doc/html/boost_optional/acknowledgments.html | 125 - .../dependencies_and_portability.html | 91 - ...emplace_operations_in_older_compilers.html | 90 - .../optional_reference_binding.html | 107 - .../boost_optional/detailed_semantics.html | 1975 -------------- doc/html/boost_optional/development.html | 412 --- doc/html/boost_optional/discussion.html | 128 - doc/html/boost_optional/examples.html | 147 - .../exception_safety_guarantees.html | 170 -- .../boost_optional/implementation_notes.html | 55 - .../boost_optional/in_place_factories.html | 196 -- doc/html/boost_optional/motivation.html | 128 - .../boost_optional/optional_references.html | 114 - doc/html/boost_optional/quick_start.html | 169 -- ...sing_unnecessary_default_construction.html | 75 - .../optional_automatic_variables.html | 75 - .../quick_start/optional_data_members.html | 94 - .../quick_start/optional_return_values.html | 135 - .../quick_start/storage_in_containers.html | 64 - ...for_assignment_of_optional_references.html | 148 - .../reference/acknowledgements.html | 131 - .../dependencies_and_portability.html | 84 - .../optional_reference_binding.html | 100 - ...ost_optional_bad_optional_access_hpp_.html | 63 - .../detailed_semantics.html | 60 - .../header__boost_optional_hpp_.html | 47 - ...der__boost_optional_optional_fwd_hpp_.html | 66 - .../detailed_semantics.html | 2423 ----------------- .../detailed_semantics____free_functions.html | 447 --- ...iled_semantics____optional_references.html | 57 - ...detailed_semantics____optional_values.html | 1983 -------------- .../detailed_semantics___free_functions.html | 521 ---- ...ailed_semantics___optional_references.html | 552 ---- .../detailed_semantics___optional_values.html | 1788 ------------ .../header__boost_optional_hpp_.html | 47 - .../header_optional_in_place_init.html | 61 - .../header_optional_optional_refs.html | 118 - .../header_optional_optional_values.html | 153 -- .../boost_optional/reference/io_header.html | 72 - .../reference/io_header/io_semantics.html | 112 - .../boost_optional/reference/relnotes.html | 183 -- doc/html/boost_optional/relnotes.html | 384 --- doc/html/boost_optional/synopsis.html | 174 -- doc/html/boost_optional/tutorial.html | 523 ---- .../tutorial/a_note_about_optional_bool_.html | 108 - .../tutorial/design_overview.html | 184 -- .../design_overview/the_interface.html | 187 -- .../design_overview/the_semantics.html | 121 - .../tutorial/exception_safety_guarantees.html | 175 -- doc/html/boost_optional/tutorial/gotchas.html | 112 - ...e_positive_with__wmaybe_uninitialized.html | 77 - .../gotchas/mixed_relational_comparisons.html | 59 - .../gotchas/moved_from__optional_.html | 63 - .../tutorial/in_place_factories.html | 197 -- .../boost_optional/tutorial/io_operators.html | 87 - .../boost_optional/tutorial/motivation.html | 129 - .../tutorial/optional_references.html | 117 - ...for_assignment_of_optional_references.html | 147 - .../tutorial/performance_considerations.html | 265 -- ...for_assignment_of_optional_references.html | 149 - .../tutorial/relational_operators.html | 113 - .../tutorial/type_requirements.html | 109 - .../tutorial/when_to_use_optional.html | 142 - .../boost_optional/type_requirements.html | 61 - doc/html/images/opt_align1.png | Bin 417 -> 0 bytes doc/html/images/opt_align2.png | Bin 472 -> 0 bytes doc/html/images/opt_align3.png | Bin 468 -> 0 bytes doc/html/images/opt_align4.png | Bin 428 -> 0 bytes doc/html/index.html | 154 -- doc/html/optional/reference.html | 89 - .../header__boost_optional_optional_hpp_.html | 111 - doc/html/optional/tutorial.html | 153 -- doc/{html/images/callouts => images}/R.png | Bin doc/{html => }/images/space.png | Bin 78 files changed, 5 insertions(+), 17997 deletions(-) delete mode 100644 doc/html/boost_optional/a_note_about_optional_bool_.html delete mode 100644 doc/html/boost_optional/acknowledgements.html delete mode 100644 doc/html/boost_optional/acknowledgments.html delete mode 100644 doc/html/boost_optional/dependencies_and_portability.html delete mode 100644 doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html delete mode 100644 doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html delete mode 100644 doc/html/boost_optional/detailed_semantics.html delete mode 100644 doc/html/boost_optional/development.html delete mode 100644 doc/html/boost_optional/discussion.html delete mode 100644 doc/html/boost_optional/examples.html delete mode 100644 doc/html/boost_optional/exception_safety_guarantees.html delete mode 100644 doc/html/boost_optional/implementation_notes.html delete mode 100644 doc/html/boost_optional/in_place_factories.html delete mode 100644 doc/html/boost_optional/motivation.html delete mode 100644 doc/html/boost_optional/optional_references.html delete mode 100644 doc/html/boost_optional/quick_start.html delete mode 100644 doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html delete mode 100644 doc/html/boost_optional/quick_start/optional_automatic_variables.html delete mode 100644 doc/html/boost_optional/quick_start/optional_data_members.html delete mode 100644 doc/html/boost_optional/quick_start/optional_return_values.html delete mode 100644 doc/html/boost_optional/quick_start/storage_in_containers.html delete mode 100644 doc/html/boost_optional/rebinding_semantics_for_assignment_of_optional_references.html delete mode 100644 doc/html/boost_optional/reference/acknowledgements.html delete mode 100644 doc/html/boost_optional/reference/dependencies_and_portability.html delete mode 100644 doc/html/boost_optional/reference/dependencies_and_portability/optional_reference_binding.html delete mode 100644 doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html delete mode 100644 doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html delete mode 100644 doc/html/boost_optional/reference/header__boost_optional_hpp_.html delete mode 100644 doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html delete mode 100644 doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html delete mode 100644 doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____free_functions.html delete mode 100644 doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____optional_references.html delete mode 100644 doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____optional_values.html delete mode 100644 doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html delete mode 100644 doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html delete mode 100644 doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html delete mode 100644 doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header__boost_optional_hpp_.html delete mode 100644 doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html delete mode 100644 doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html delete mode 100644 doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html delete mode 100644 doc/html/boost_optional/reference/io_header.html delete mode 100644 doc/html/boost_optional/reference/io_header/io_semantics.html delete mode 100644 doc/html/boost_optional/reference/relnotes.html delete mode 100644 doc/html/boost_optional/relnotes.html delete mode 100644 doc/html/boost_optional/synopsis.html delete mode 100644 doc/html/boost_optional/tutorial.html delete mode 100644 doc/html/boost_optional/tutorial/a_note_about_optional_bool_.html delete mode 100644 doc/html/boost_optional/tutorial/design_overview.html delete mode 100644 doc/html/boost_optional/tutorial/design_overview/the_interface.html delete mode 100644 doc/html/boost_optional/tutorial/design_overview/the_semantics.html delete mode 100644 doc/html/boost_optional/tutorial/exception_safety_guarantees.html delete mode 100644 doc/html/boost_optional/tutorial/gotchas.html delete mode 100644 doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html delete mode 100644 doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html delete mode 100644 doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html delete mode 100644 doc/html/boost_optional/tutorial/in_place_factories.html delete mode 100644 doc/html/boost_optional/tutorial/io_operators.html delete mode 100644 doc/html/boost_optional/tutorial/motivation.html delete mode 100644 doc/html/boost_optional/tutorial/optional_references.html delete mode 100644 doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html delete mode 100644 doc/html/boost_optional/tutorial/performance_considerations.html delete mode 100644 doc/html/boost_optional/tutorial/rebinding_semantics_for_assignment_of_optional_references.html delete mode 100644 doc/html/boost_optional/tutorial/relational_operators.html delete mode 100644 doc/html/boost_optional/tutorial/type_requirements.html delete mode 100644 doc/html/boost_optional/tutorial/when_to_use_optional.html delete mode 100644 doc/html/boost_optional/type_requirements.html delete mode 100644 doc/html/images/opt_align1.png delete mode 100644 doc/html/images/opt_align2.png delete mode 100644 doc/html/images/opt_align3.png delete mode 100644 doc/html/images/opt_align4.png delete mode 100644 doc/html/index.html delete mode 100644 doc/html/optional/reference.html delete mode 100644 doc/html/optional/reference/header__boost_optional_optional_hpp_.html delete mode 100644 doc/html/optional/tutorial.html rename doc/{html/images/callouts => images}/R.png (100%) rename doc/{html => }/images/space.png (100%) diff --git a/doc/00_optional.qbk b/doc/00_optional.qbk index b99f8dc5..2381794e 100644 --- a/doc/00_optional.qbk +++ b/doc/00_optional.qbk @@ -2,7 +2,7 @@ [quickbook 1.4] [authors [Cacciola Carballal, Fernando Luis]] [copyright 2003-2007 Fernando Luis Cacciola Carballal] - [copyright 2014-2023 Andrzej Krzemieński] + [copyright 2014-2024 Andrzej Krzemieński] [category miscellaneous] [id optional] [dirname optional] @@ -47,7 +47,7 @@ Distributed under the Boost Software License, Version 1.0. [/ Icons ] [def __SPACE__ [$images/space.png]] -[def __GO_TO__ [$images/callouts/R.png]] +[def __GO_TO__ [$images/R.png]] [section Introduction] diff --git a/doc/Jamfile.v2 b/doc/Jamfile.v2 index 91af84f3..c33abf8f 100644 --- a/doc/Jamfile.v2 +++ b/doc/Jamfile.v2 @@ -26,6 +26,8 @@ install images images/opt_align2.png images/opt_align3.png images/opt_align4.png + images/R.png + images/space.png : html/images ; @@ -38,7 +40,7 @@ boostbook standalone html:"boost.libraries=../../../../libs/libraries.htm" "chapter.autolabel=0" "chunk.section.depth=8" - "toc.section.depth=2" + "toc.section.depth=1" "toc.max.depth=2" "generate.section.toc.level=1" pdf:"img.src.path=$(images)/" diff --git a/doc/html/boost_optional/a_note_about_optional_bool_.html b/doc/html/boost_optional/a_note_about_optional_bool_.html deleted file mode 100644 index 64f37f68..00000000 --- a/doc/html/boost_optional/a_note_about_optional_bool_.html +++ /dev/null @@ -1,108 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -

      -
      -PrevUpHomeNext -
      -
      -
      -

      - optional<bool> should - be used with special caution and consideration. -

      -

      - First, it is functionally similar to a tristate boolean (false, maybe, true) - —such as boost::tribool— - except that in a tristate boolean, the maybe state represents - a valid value, unlike the corresponding state of an uninitialized - optional<bool>. It - should be carefully considered if an optional<bool> - instead of a tribool is really - needed. -

      -

      - Second, although optional<> - provides a contextual conversion to bool - in C++11, this falls back to an implicit conversion on older compilers. This - conversion refers to the initialization state and not to the contained value. - Using optional<bool> can - lead to subtle errors due to the implicit bool - conversion: -

      -
      void foo ( bool v ) ;
-void bar()
-{
-    optional<bool> v = try();
-
-    // The following intended to pass the value of 'v' to foo():
-    foo(v);
-    // But instead, the initialization state is passed
-    // due to a typo: it should have been foo(*v).
-}
-
      -

      - The only implicit conversion is to bool, - and it is safe in the sense that typical integral promotions don't apply (i.e. - if foo() - takes an int instead, it won't - compile). -

      -

      - Third, mixed comparisons with bool - work differently than similar mixed comparisons between pointers and bool, so the results might surprise you: -

      -
      optional<bool> oEmpty(none), oTrue(true), oFalse(false);
-
-if (oEmpty == none);  // renders true
-if (oEmpty == false); // renders false!
-if (oEmpty == true);  // renders false!
-
-if (oFalse == none);  // renders false
-if (oFalse == false); // renders true!
-if (oFalse == true);  // renders false
-
-if (oTrue == none);   // renders false
-if (oTrue == false);  // renders false
-if (oTrue == true);   // renders true
-
      -

      - In other words, for optional<>, the following assertion does not hold: -

      -
      assert((opt == false) == (!opt));
-
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/acknowledgements.html b/doc/html/boost_optional/acknowledgements.html deleted file mode 100644 index 54195804..00000000 --- a/doc/html/boost_optional/acknowledgements.html +++ /dev/null @@ -1,130 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHome -
      -
      -
      -

      - - Pre-formal - review -

      -
        -
      • - Peter Dimov suggested the name 'optional', and was the first to point out - the need for aligned storage. -
        • -
      • - Douglas Gregor developed 'type_with_alignment', and later Eric Friedman - coded 'aligned_storage', which are the core of the optional class implementation. -
        • -
      • - Andrei Alexandrescu and Brian Parker also worked with aligned storage techniques - and their work influenced the current implementation. -
        • -
      • - Gennadiy Rozental made extensive and important comments which shaped the - design. -
        • -
      • - Vesa Karvonen and Douglas Gregor made quite useful comparisons between - optional, variant and any; and made other relevant comments. -
        • -
      • - Douglas Gregor and Peter Dimov commented on comparisons and evaluation - in boolean contexts. -
        • -
      • - Eric Friedman helped understand the issues involved with aligned storage, - move/copy operations and exception safety. -
        • -
      • - Many others have participated with useful comments: Aleksey Gurotov, Kevlin - Henney, David Abrahams, and others I can't recall. -
        • -
      -

      - - Post-formal - review -

      -
        -
      • - William Kempf carefully considered the originally proposed interface and - suggested the new interface which is currently used. He also started and - fueled the discussion about the analogy optional<>/smart pointer - and about relational operators. -
        • -
      • - Peter Dimov, Joel de Guzman, David Abrahams, Tanton Gibbs and Ian Hanson - focused on the relational semantics of optional (originally undefined); - concluding with the fact that the pointer-like interface doesn't make it - a pointer so it shall have deep relational operators. -
        • -
      • - Augustus Saunders also explored the different relational semantics between - optional<> and a pointer and developed the OptionalPointee concept - as an aid against potential conflicts on generic code. -
        • -
      • - Joel de Guzman noticed that optional<> can be seen as an API on top - of variant<T,nil_t>. -
        • -
      • - Dave Gomboc explained the meaning and usage of the Haskell analog to optional<>: - the Maybe type constructor (analogy originally pointed out by David Sankel). -
        • -
      • - Other comments were posted by Vincent Finn, Anthony Williams, Ed Brey, - Rob Stewart, and others. -
        • -
      • - Joel de Guzman made the case for the support of references and helped with - the proper semantics. -
        • -
      • - Mat Marcus shown the virtues of a value-oriented interface, influencing - the current design, and contributed the idea of "none". -
        • -
      • - Vladimir Batov's design of Boost.Convert library motivated the development - of value accessors for optional: - functions value, value_or, value_or_eval. -
        • -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHome -
      - - diff --git a/doc/html/boost_optional/acknowledgments.html b/doc/html/boost_optional/acknowledgments.html deleted file mode 100644 index b09cf6e1..00000000 --- a/doc/html/boost_optional/acknowledgments.html +++ /dev/null @@ -1,125 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHome -
      -
      -
      -

      - - Pre-formal - review -

      -
        -
      • - Peter Dimov suggested the name 'optional', and was the first to point out - the need for aligned storage. -
        • -
      • - Douglas Gregor developed 'type_with_alignment', and later Eric Friedman - coded 'aligned_storage', which are the core of the optional class implementation. -
        • -
      • - Andrei Alexandrescu and Brian Parker also worked with aligned storage techniques - and their work influenced the current implementation. -
        • -
      • - Gennadiy Rozental made extensive and important comments which shaped the - design. -
        • -
      • - Vesa Karvonen and Douglas Gregor made quite useful comparisons between - optional, variant and any; and made other relevant comments. -
        • -
      • - Douglas Gregor and Peter Dimov commented on comparisons and evaluation - in boolean contexts. -
        • -
      • - Eric Friedman helped understand the issues involved with aligned storage, - move/copy operations and exception safety. -
        • -
      • - Many others have participated with useful comments: Aleksey Gurotov, Kevlin - Henney, David Abrahams, and others I can't recall. -
        • -
      -

      - - Post-formal - review -

      -
        -
      • - William Kempf carefully considered the originally proposed interface and - suggested the new interface which is currently used. He also started and - fueled the discussion about the analogy optional<>/smart pointer - and about relational operators. -
        • -
      • - Peter Dimov, Joel de Guzman, David Abrahams, Tanton Gibbs and Ian Hanson - focused on the relational semantics of optional (originally undefined); - concluding with the fact that the pointer-like interface doesn't make it - a pointer so it shall have deep relational operators. -
        • -
      • - Augustus Saunders also explored the different relational semantics between - optional<> and a pointer and developed the OptionalPointee concept - as an aid against potential conflicts on generic code. -
        • -
      • - Joel de Guzman noticed that optional<> can be seen as an API on top - of variant<T,nil_t>. -
        • -
      • - Dave Gomboc explained the meaning and usage of the Haskell analog to optional<>: - the Maybe type constructor (analogy originally pointed out by David Sankel). -
        • -
      • - Other comments were posted by Vincent Finn, Anthony Williams, Ed Brey, - Rob Stewart, and others. -
        • -
      • - Joel de Guzman made the case for the support of references and helped with - the proper semantics. -
        • -
      • - Mat Marcus shown the virtues of a value-oriented interface, influencing - the current design, and contributed the idea of "none". -
        • -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHome -
      - - diff --git a/doc/html/boost_optional/dependencies_and_portability.html b/doc/html/boost_optional/dependencies_and_portability.html deleted file mode 100644 index 2b4f7c43..00000000 --- a/doc/html/boost_optional/dependencies_and_portability.html +++ /dev/null @@ -1,91 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      -
      Dependencies
      -
      Emplace - operations in older compilers
      -
      Optional - Reference Binding
      -
      -
      -
      -

      - The implementation uses the following other Boost modules: -

      -
        -
      1. - assert -
        2. -
      2. - config -
        3. -
      3. - core -
        4. -
      4. - detail -
        5. -
      5. - move -
        6. -
      6. - mpl -
        7. -
      7. - static_assert -
        8. -
      8. - throw_exception -
        9. -
      9. - type_traits -
        10. -
      10. - utility -
        11. -
      -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html b/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html deleted file mode 100644 index e4c08bcb..00000000 --- a/doc/html/boost_optional/dependencies_and_portability/emplace_operations_in_older_compilers.html +++ /dev/null @@ -1,90 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Certain constructors and functions - in the interface of optional - perform a 'perfect forwarding' of arguments: -

      -
      template<class... Args> optional(in_place_init_t, Args&&... args);
-template<class... Args> optional(in_place_init_if_t, bool condition, Args&&... args);
-template<class... Args> void emplace(Args&&... args);
-
      -

      - On compilers that do not support variadic templates, each of these functions - is substituted with two overloads, one forwarding a single argument, the - other forwarding zero arguments. This forms the following set: -

      -
      template<class Arg> optional(in_place_init_t, Arg&& arg);
-optional(in_place_init_t);
-
-template<class Arg> optional(in_place_init_if_t, bool condition, Arg&& arg);
-optional(in_place_init_if_t, bool condition);
-
-template<class Arg> void emplace(Arg&& arg);
-void emplace();
-
      -

      - On compilers that do not support rvalue references, each of these functions - is substituted with three overloads: taking const - and non-const lvalue reference, - and third forwarding zero arguments. This forms the following set: -

      -
      template<class Arg> optional(in_place_init_t, const Arg& arg);
-template<class Arg> optional(in_place_init_t, Arg& arg);
-optional(in_place_init_t);
-
-template<class Arg> optional(in_place_init_if_t, bool condition, const Arg& arg);
-template<class Arg> optional(in_place_init_if_t, bool condition, Arg& arg);
-optional(in_place_init_if_t, bool condition);
-
-template<class Arg> void emplace(const Arg& arg);
-template<class Arg> void emplace(Arg& arg);
-void emplace();
-
      -

      - This workaround addresses about 40% of all use cases. If this is insufficient, - you need to resort to using In-Place - Factories. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html b/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html deleted file mode 100644 index 9bd61868..00000000 --- a/doc/html/boost_optional/dependencies_and_portability/optional_reference_binding.html +++ /dev/null @@ -1,107 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - A number of compilers incorrectly - treat const lvalues of integral type as rvalues, and create an illegal temporary - when binding to an lvalue reference to const in some expressions. This could - result in creating an optional lvalue reference that is in fact bound to - an unexpected temporary rather than to the intended object. In order to prevent - hard to find run-time bugs, this library performs compile-time checks to - prevent expressions that would otherwise bind an optional reference to an - unexpected temporary. As a consequence, on certain compilers certain pieces - of functionality in optional references are missing. In order to maintain - a portability of your code across different compilers, it is recommended that - you only stick to the minimum portable interface of optional references: - prefer direct-initialization and copy assignment of optional references to - copy-initialization and assignment from T&: -

      -
      const int i = 0;
-optional<const int&> or1;
-optional<const int&> or2 = i;  // caution: not portable
-or1 = i;                       // caution: not portable
-
-optional<const int&> or3(i);   // portable
-or1 = optional<const int&>(i); // portable
-
      -

      - Compilers known to have these deficiencies include GCC versions 4.2, 4.3, - 4.4, 4.5, 5.1, 5.2; QCC 4.4.2; MSVC versions 8.0, 9.0, 10.0, 11.0, 12.0. - In order to check if your compiler correctly implements reference binding - use this test program. -

      -
      #include <cassert>
-
-const int global_i = 0;
-
-struct TestingReferenceBinding
-{
-  TestingReferenceBinding(const int& ii)
-  {
-    assert(&ii == &global_i);
-  }
-
-  void operator=(const int& ii)
-  {
-    assert(&ii == &global_i);
-  }
-
-  void operator=(int&&) // remove this if your compiler doesn't have rvalue refs
-  {
-    assert(false);
-  }
-};
-
-int main()
-{
-  const int& iref = global_i;
-  assert(&iref == &global_i);
-
-  TestingReferenceBinding ttt = global_i;
-  ttt = global_i;
-
-  TestingReferenceBinding ttt2 = iref;
-  ttt2 = iref;
-}
-
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/detailed_semantics.html b/doc/html/boost_optional/detailed_semantics.html deleted file mode 100644 index 28aa8150..00000000 --- a/doc/html/boost_optional/detailed_semantics.html +++ /dev/null @@ -1,1975 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Because T might be of reference - type, in the sequel, those entries whose semantic depends on T being of reference type or not will be - distinguished using the following convention: -

      -
        -
      • - If the entry reads: optional<T(not - a ref)>, the - description corresponds only to the case where T - is not of reference type. -
        • -
      • - If the entry reads: optional<T&>, the description corresponds only - to the case where T is - of reference type. -
        • -
      • - If the entry reads: optional<T>, the description is the same for both - cases. -
        • -
      -
      - - - - - -
      [Note]Note

      - The following section contains various assert() which are used only to show the postconditions - as sample code. It is not implied that the type T - must support each particular expression but that if the expression is supported, - the implied condition holds. -

      -

      - space -

      -

      - - optional - class member functions -

      -

      - space -

      -

      - optional<T>::optional() noexcept; -

      -
        -
      • - Effect: Default-Constructs an optional. -
        • -
      • - Postconditions: *this is uninitialized. -
        • -
      • - Notes: T's default constructor is not called. -
        • -
      • - Example: -
        optional<T> def ;
-assert ( !def ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T>::optional( none_t ) noexcept; -

      -
        -
      • - Effect: Constructs an optional - uninitialized. -
        • -
      • - Postconditions: *this is uninitialized. -
        • -
      • - Notes: T's - default constructor is not called. - The expression boost::none denotes an instance of boost::none_t that can be used as the parameter. -
        • -
      • - Example: -
        #include <boost/none.hpp>
-optional<T> n(none) ;
-assert ( !n ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T (not a ref)>::optional( T const& v ) -

      -
        -
      • - Requires: is_copy_constructible<T>::value - is true. -
        • -
      • - Effect: Directly-Constructs an optional. -
        • -
      • - Postconditions: *this is initialized - and its value is a copy of v. -
        • -
      • - Throws: Whatever T::T( - T const& ) - throws. -
        • -
      • - Notes: T::T( - T const& ) - is called. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T - const& - ); in that case, this constructor - has no effect. -
        • -
      • - Example: -
        T v;
-optional<T> opt(v);
-assert ( *opt == v ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>::optional( T& ref ) -

      -
        -
      • - Effect: Directly-Constructs an optional. -
        • -
      • - Postconditions: *this is initialized - and its value is an instance of an internal type wrapping the reference - ref. -
        • -
      • - Throws: Nothing. -
        • -
      • - Example: -
        T v;
-T& vref = v ;
-optional<T&> opt(vref);
-assert ( *opt == v ) ;
-++ v ; // mutate referee
-assert (*opt == v);
-
        -
        • -
      -

      - space -

      -

      - optional<T (not a ref)>::optional( T&& - v ) -

      -
        -
      • - Requires: is_move_constructible<T>::value - is true. -
        • -
      • - Effect: Directly-Move-Constructs an optional. -
        • -
      • - Postconditions: *this is initialized - and its value is move-constructed from v. -
        • -
      • - Throws: Whatever T::T( - T&& - ) throws. -
        • -
      • - Notes: T::T( - T&& - ) is called. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T&& ); - in that case, the state of v - is determined by exception safety guarantees for T::T(T&&). -
        • -
      • - Example: -
        T v1, v2;
-optional<T> opt(std::move(v1));
-assert ( *opt == v2 ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>::optional( T&& ref ) = delete -

      -
      • - Notes: This constructor is deleted -
      -

      - space -

      -

      - optional<T (not a ref)>::optional( bool condition, T const& v ) ; -

      -

      - optional<T&> ::optional( bool condition, T& - v ) ; -

      -
      • - If condition is true, same as: -
      -

      - optional<T (not a ref)>::optional( T const& v ) -

      -

      - optional<T&> ::optional( T& - v ) -

      -
      • - otherwise, same as: -
      -

      - optional<T (not a ref)>::optional() -

      -

      - optional<T&> ::optional() -

      -

      - space -

      -

      - optional<T (not a ref)>::optional( optional const& rhs ); -

      -
        -
      • - Requires: is_copy_constructible<T>::value - is true. -
        • -
      • - Effect: Copy-Constructs an optional. -
        • -
      • - Postconditions: If rhs is initialized, - *this - is initialized and its value is a copy of the value - of rhs; else *this is - uninitialized. -
        • -
      • - Throws: Whatever T::T( - T const& ) - throws. -
        • -
      • - Notes: If rhs is initialized, T::T(T const& ) - is called. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T - const& - ); in that case, this constructor - has no effect. -
        • -
      • - Example: -
        optional<T> uninit ;
-assert (!uninit);
-
-optional<T> uinit2 ( uninit ) ;
-assert ( uninit2 == uninit );
-
-optional<T> init( T(2) );
-assert ( *init == T(2) ) ;
-
-optional<T> init2 ( init ) ;
-assert ( init2 == init ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>::optional( optional const& rhs ); -

      -
        -
      • - Effect: Copy-Constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is another reference to the same object referenced - by *rhs; - else *this - is uninitialized. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: If rhs - is initialized, both *this - and *rhs - will reefer to the same object (they alias). -
        • -
      • - Example: -
        optional<T&> uninit ;
-assert (!uninit);
-
-optional<T&> uinit2 ( uninit ) ;
-assert ( uninit2 == uninit );
-
-T v = 2 ; T& ref = v ;
-optional<T> init(ref);
-assert ( *init == v ) ;
-
-optional<T> init2 ( init ) ;
-assert ( *init2 == v ) ;
-
-v = 3 ;
-
-assert ( *init  == 3 ) ;
-assert ( *init2 == 3 ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T (not a ref)>::optional( optional&& rhs - ) noexcept(see below); -

      -
        -
      • - Requires: is_move_constructible<T>::value - is true. -
        • -
      • - Effect: Move-constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is move constructed from rhs; - else *this - is uninitialized. -
        • -
      • - Throws: Whatever T::T( - T&& - ) throws. -
        • -
      • - Notes: If rhs - is initialized, T::T( T - && ) - is called. The expression inside noexcept - is equivalent to is_nothrow_move_constructible<T>::value. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T&& ); - in that case, rhs remains - initialized and the value of *rhs is determined by exception safety - of T::T(T&&). -
        • -
      • - Example: -
        optional<std::unique_ptr<T>> uninit ;
-assert (!uninit);
-
-optional<std::unique_ptr<T>> uinit2 ( std::move(uninit) ) ;
-assert ( uninit2 == uninit );
-
-optional<std::unique_ptr<T>> init( std::unique_ptr<T>(new T(2)) );
-assert ( **init == T(2) ) ;
-
-optional<std::unique_ptr<T>> init2 ( std::move(init) ) ;
-assert ( init );
-assert ( *init == nullptr );
-assert ( init2 );
-assert ( **init2 == T(2) ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>::optional( optional && - rhs ); -

      -
        -
      • - Effect: Move-Constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is another reference to the same object referenced - by *rhs; - else *this - is uninitialized. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: If rhs - is initialized, both *this - and *rhs - will reefer to the same object (they alias). -
        • -
      • - Example: -
        optional<std::unique_ptr<T>&> uninit ;
-assert (!uninit);
-
-optional<std::unique_ptr<T>&> uinit2 ( std::move(uninit) ) ;
-assert ( uninit2 == uninit );
-
-std::unique_ptr<T> v(new T(2)) ;
-optional<std::unique_ptr<T>&> init(v);
-assert ( *init == v ) ;
-
-optional<std::unique_ptr<T>&> init2 ( std::move(init) ) ;
-assert ( *init2 == v ) ;
-
-*v = 3 ;
-
-assert ( **init  == 3 ) ;
-assert ( **init2 == 3 ) ;
-
        -
        • -
      -

      - space -

      -

      - template<U> explicit optional<T - (not a ref)>::optional( optional<U> const& rhs ); -

      -
        -
      • - Effect: Copy-Constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is a copy of the value - of rhs converted to type T; - else *this - is uninitialized. -
        • -
      • - Throws: Whatever T::T( - U const& ) - throws. -
        • -
      • - Notes: T::T( - U const& ) - is called if rhs is initialized, - which requires a valid conversion from U - to T. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( U - const& - ); in that case, this constructor - has no effect. -
        • -
      • - Example: -
        optional<double> x(123.4);
-assert ( *x == 123.4 ) ;
-
-optional<int> y(x) ;
-assert( *y == 123 ) ;
-
        -
        • -
      -

      - space -

      -

      - template<U> explicit optional<T - (not a ref)>::optional( optional<U>&& - rhs ); -

      -
        -
      • - Effect: Move-constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is move constructed from *rhs; else *this is uninitialized. -
        • -
      • - Throws: Whatever T::T( - U&& - ) throws. -
        • -
      • - Notes: T::T( - U&& - ) is called if rhs - is initialized, which requires a valid conversion from U - to T. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( U&& ); - in that case, rhs remains - initialized and the value of *rhs is determined by exception safety - guarantee of T::T( U&& ). -
        • -
      • - Example: -
        optional<double> x(123.4);
-assert ( *x == 123.4 ) ;
-
-optional<int> y(std::move(x)) ;
-assert( *y == 123 ) ;
-
        -
        • -
      -

      - space -

      -

      - template<InPlaceFactory> - explicit optional<T - (not a ref)>::optional( InPlaceFactory const& f ); -

      -

      - template<TypedInPlaceFactory> - explicit optional<T - (not a ref)>::optional( TypedInPlaceFactory const& f ); -

      -
        -
      • - Effect: Constructs an optional - with a value of T obtained - from the factory. -
        • -
      • - Postconditions: *this is initialized - and its value is directly given from the factory - f (i.e., the value is not copied). -
        • -
      • - Throws: Whatever the T - constructor called by the factory throws. -
        • -
      • - Notes: See In-Place - Factories -
        • -
      • - Exception Safety: Exceptions can only - be thrown during the call to the T - constructor used by the factory; in that case, this constructor has no - effect. -
        • -
      • - Example: -
        class C { C ( char, double, std::string ) ; } ;
-
-C v('A',123.4,"hello");
-
-optional<C> x( in_place   ('A', 123.4, "hello") ); // InPlaceFactory used
-optional<C> y( in_place<C>('A', 123.4, "hello") ); // TypedInPlaceFactory used
-
-assert ( *x == v ) ;
-assert ( *y == v ) ;
-
        -
        • -
      -

      - space -

      -

      - optional& - optional<T>::operator= ( none_t ) noexcept; -

      -
        -
      • - Effect: If *this is initialized destroys its contained - value. -
        • -
      • - Postconditions: *this is uninitialized. -
        • -
      -

      - space -

      -

      - optional& - optional<T (not a ref)>::operator= ( T - const& - rhs ) - ; -

      -
        -
      • - Effect: Assigns the value rhs to an optional. -
        • -
      • - Postconditions: *this is initialized and its value is a - copy of rhs. -
        • -
      • - Throws: Whatever T::operator=( T const& ) or T::T(T const&) throws. -
        • -
      • - Notes: If *this was initialized, T's - assignment operator is used, otherwise, its copy-constructor is used. -
        • -
      • - Exception Safety: In the event of an exception, - the initialization state of *this is unchanged and its value unspecified - as far as optional is concerned - (it is up to T's operator=()). - If *this - is initially uninitialized and T's - copy constructor fails, *this is left properly uninitialized. -
        • -
      • - Example: -
        T x;
-optional<T> def ;
-optional<T> opt(x) ;
-
-T y;
-def = y ;
-assert ( *def == y ) ;
-opt = y ;
-assert ( *opt == y ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>& - optional<T&>::operator= ( T& - rhs ) - ; -

      -
        -
      • - Effect: (Re)binds the wrapped reference. -
        • -
      • - Postconditions: *this is initialized and it references the - same object referenced by rhs. -
        • -
      • - Notes: If *this was initialized, it is rebound - to the new object. See here - for details on this behavior. -
        • -
      • - Example: -
        int a = 1 ;
-int b = 2 ;
-T& ra = a ;
-T& rb = b ;
-optional<int&> def ;
-optional<int&> opt(ra) ;
-
-def = rb ; // binds 'def' to 'b' through 'rb'
-assert ( *def == b ) ;
-*def = a ; // changes the value of 'b' to a copy of the value of 'a'
-assert ( b == a ) ;
-int c = 3;
-int& rc = c ;
-opt = rc ; // REBINDS to 'c' through 'rc'
-c = 4 ;
-assert ( *opt == 4 ) ;
-
        -
        • -
      -

      - space -

      -

      - optional& - optional<T (not a ref)>::operator= ( T&& rhs - ) ; -

      -
        -
      • - Effect: Moves the value rhs to an optional. -
        • -
      • - Postconditions: *this is initialized and its value is moved - from rhs. -
        • -
      • - Throws: Whatever T::operator=( T&& ) - or T::T(T - &&) throws. -
        • -
      • - Notes: If *this was initialized, T's - move-assignment operator is used, otherwise, its move-constructor is used. -
        • -
      • - Exception Safety: In the event of an exception, - the initialization state of *this is unchanged and its value unspecified - as far as optional is concerned - (it is up to T's operator=()). - If *this - is initially uninitialized and T's - move constructor fails, *this is left properly uninitialized. -
        • -
      • - Example: -
        T x;
-optional<T> def ;
-optional<T> opt(x) ;
-
-T y1, y2, yR;
-def = std::move(y1) ;
-assert ( *def == yR ) ;
-opt = std::move(y2) ;
-assert ( *opt == yR ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>& - optional<T&>::operator= ( T&& - rhs ) - = delete; -

      -
      • - Notes: This assignment operator is deleted. -
      -

      - space -

      -

      - optional& - optional<T (not a ref)>::operator= ( optional - const& - rhs ) - ; -

      -
        -
      • - Effect: Assigns another optional to an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is a copy of the value - of rhs; else *this is - uninitialized. -
        • -
      • - Throws: Whatever T::operator( T const&) - or T::T( T - const& - ) throws. -
        • -
      • - Notes: If both *this and rhs - are initially initialized, T's - assignment operator is used. If *this is initially initialized but rhs is uninitialized, T's - [destructor] is called. If *this is initially uninitialized but rhs is initialized, T's - copy constructor is called. -
        • -
      • - Exception Safety: In the event of an exception, - the initialization state of *this is unchanged and its value unspecified - as far as optional is concerned (it is up to T's - operator=()). - If *this - is initially uninitialized and T's - copy constructor fails, *this is left properly uninitialized. -
        • -
      • - Example: -
        T v;
-optional<T> opt(v);
-optional<T> def ;
-
-opt = def ;
-assert ( !def ) ;
-// previous value (copy of 'v') destroyed from within 'opt'.
-
        -
        • -
      -

      - space -

      -

      - optional<T&> & optional<T&>::operator= ( optional<T&> - const& - rhs ) - ; -

      -
        -
      • - Effect: (Re)binds thee wrapped reference. -
        • -
      • - Postconditions: If *rhs is initialized, *this is initialized and it references the - same object referenced by *rhs; otherwise, *this is uninitialized (and references no - object). -
        • -
      • - Notes: If *this was initialized and so is *rhs, - *this - is rebound to the new object. See here - for details on this behavior. -
        • -
      • - Example: -
        int a = 1 ;
-int b = 2 ;
-T& ra = a ;
-T& rb = b ;
-optional<int&> def ;
-optional<int&> ora(ra) ;
-optional<int&> orb(rb) ;
-
-def = orb ; // binds 'def' to 'b' through 'rb' wrapped within 'orb'
-assert ( *def == b ) ;
-*def = ora ; // changes the value of 'b' to a copy of the value of 'a'
-assert ( b == a ) ;
-int c = 3;
-int& rc = c ;
-optional<int&> orc(rc) ;
-ora = orc ; // REBINDS ora to 'c' through 'rc'
-c = 4 ;
-assert ( *ora == 4 ) ;
-
        -
        • -
      -

      - space -

      -

      - optional& - optional<T (not a ref)>::operator= ( optional&& rhs - ) noexcept(see below); -

      -
        -
      • - Effect: Move-assigns another optional to an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is moved from *rhs, rhs - remains initialized; else *this is uninitialized. -
        • -
      • - Throws: Whatever T::operator( T&& - ) or T::T( - T && - ) throws. -
        • -
      • - Notes: If both *this and rhs - are initially initialized, T's - move assignment operator is used. If *this is - initially initialized but rhs - is uninitialized, T's [destructor] - is called. If *this - is initially uninitialized but rhs - is initialized, T's move - constructor is called. The expression inside noexcept - is equivalent to is_nothrow_move_constructible<T>::value - && is_nothrow_move_assignable<T>::value. -
        • -
      • - Exception Safety: In the event of an exception, - the initialization state of *this is unchanged and its value unspecified - as far as optional is concerned (it is up to T's - operator=()). - If *this - is initially uninitialized and T's - move constructor fails, *this is left properly uninitialized. -
        • -
      • - Example: -
        optional<T> opt(T(2)) ;
-optional<T> def ;
-
-opt = def ;
-assert ( def ) ;
-assert ( opt ) ;
-assert ( *opt == T(2) ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&> & optional<T&>::operator= ( optional<T&>&& - rhs ) - ; -

      -
      • - Effect: Same as optional<T&>::operator= ( optional<T&> const& rhs ). -
      -

      - space -

      -

      - template<U> optional& - optional<T (not a ref)>::operator= ( optional<U> - const& - rhs ) - ; -

      -
        -
      • - Effect: Assigns another convertible optional - to an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is a copy of the value - of rhs converted - to type T; else *this is - uninitialized. -
        • -
      • - Throws: Whatever T::operator=( U const& ) or T::T( - U const& ) - throws. -
        • -
      • - Notes: If both *this and rhs are initially initialized, - T's assignment - operator (from U) - is used. If *this - is initially initialized but rhs - is uninitialized, T's - destructor is called. If *this is initially uninitialized but rhs - is initialized, T's converting - constructor (from U) - is called. -
        • -
      • - Exception Safety: In the event of an exception, - the initialization state of *this is unchanged and its value unspecified - as far as optional is concerned (it is up to T's - operator=()). - If *this - is initially uninitialized and T's - converting constructor fails, *this is left properly uninitialized. -
        • -
      • - Example: -
        T v;
-optional<T> opt0(v);
-optional<U> opt1;
-
-opt1 = opt0 ;
-assert ( *opt1 == static_cast<U>(v) ) ;
-
        -
        • -
      -

      - space -

      -

      - template<U> optional& - optional<T (not a ref)>::operator= ( optional<U>&& - rhs ) - ; -

      -
        -
      • - Effect: Move-assigns another convertible - optional to an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is moved from the value of rhs; - else *this - is uninitialized. -
        • -
      • - Throws: Whatever T::operator=( U&& ) - or T::T( U&& ) - throws. -
        • -
      • - Notes: If both *this and rhs - are initially initialized, T's - assignment operator (from U&&) is used. If *this is initially initialized but rhs is uninitialized, T's - destructor is called. If *this is initially uninitialized but rhs is initialized, T's - converting constructor (from U&&) is called. -
        • -
      • - Exception Safety: In the event of an exception, - the initialization state of *this is unchanged and its value unspecified - as far as optional is concerned (it is up to T's - operator=()). - If *this - is initially uninitialized and T's - converting constructor fails, *this is left properly uninitialized. -
        • -
      • - Example: -
        T v;
-optional<T> opt0(v);
-optional<U> opt1;
-
-opt1 = std::move(opt0) ;
-assert ( *opt1 == static_cast<U>(v) ) ;
-
        -
        • -
      -

      - space -

      -

      - template<class... Args> void optional<T - (not a ref)>::emplace( Args...&& - args ); -

      -
        -
      • - Requires: The compiler supports rvalue - references and variadic templates. -
        • -
      • - Effect: If *this is initialized calls *this = - none. Then initializes in-place - the contained value as if direct-initializing an object of type T with std::forward<Args>(args).... -
        • -
      • - Postconditions: *this is initialized. -
        • -
      • - Throws: Whatever the selected T's constructor throws. -
        • -
      • - Notes: T - need not be MoveConstructible - or MoveAssignable. -
        • -
      • - Exception Safety: If an exception is thrown - during the initialization of T, - *this - is uninitialized. -
        • -
      -

      - space -

      -

      - template<InPlaceFactory> - optional<T>& optional<T (not a ref)>::operator=( InPlaceFactory - const& - f ); -

      -

      - template<TypedInPlaceFactory> - optional<T>& optional<T (not a ref)>::operator=( TypedInPlaceFactory - const& - f ); -

      -
        -
      • - Effect: Assigns an optional - with a value of T obtained - from the factory. -
        • -
      • - Postconditions: *this is initialized - and its value is directly given from the factory - f (i.e., the value is not copied). -
        • -
      • - Throws: Whatever the T - constructor called by the factory throws. -
        • -
      • - Notes: See In-Place - Factories -
        • -
      • - Exception Safety: Exceptions can only - be thrown during the call to the T - constructor used by the factory; in that case, the optional - object will be reset to be uninitialized. -
        • -
      -

      - space -

      -

      - void optional<T - (not a ref)>::reset( T const& v ) ; -

      -
      • - Deprecated: same as operator= ( T - const& - v) - ; -
      -

      - space -

      -

      - void optional<T>::reset() noexcept ; -

      -
      • - Deprecated: Same as operator=( none_t ); -
      -

      - space -

      -

      - T const& optional<T - (not a ref)>::get() const ; -

      -

      - T& - optional<T (not a ref)>::get() ; -

      -

      - inline T - const& - get ( - optional<T (not a ref)> const& ) ; -

      -

      - inline T& get ( optional<T - (not a ref)> - &) ; -

      -
        -
      • - Requires: *this is initialized -
        • -
      • - Returns: A reference to the contained - value -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted via - BOOST_ASSERT(). -
        • -
      -

      - space -

      -

      - T const& optional<T&>::get() const ; -

      -

      - T& - optional<T&>::get() ; -

      -

      - inline T - const& - get ( - optional<T&> const& ) ; -

      -

      - inline T& get ( optional<T&> - &) ; -

      -
        -
      • - Requires: *this is initialized -
        • -
      • - Returns: The - reference contained. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted via - BOOST_ASSERT(). -
        • -
      -

      - space -

      -

      - T const& optional<T - (not a ref)>::operator*() const& ; -

      -

      - T& - optional<T (not a ref)>::operator*() &; -

      -

      - T&& - optional<T (not a ref)>::operator*() &&; -

      -
        -
      • - Requires: *this is initialized -
        • -
      • - Returns: A reference to the contained - value -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted via - BOOST_ASSERT(). - On compilers that do not support ref-qualifiers on member functions these - three overloads are replaced with the classical two: a const - and non-const member functions. -
        • -
      • - Example: -
        T v ;
-optional<T> opt ( v );
-T const& u = *opt;
-assert ( u == v ) ;
-T w ;
-*opt = w ;
-assert ( *opt == w ) ;
-
        -
        • -
      -

      - space -

      -

      - T const& optional<T&>::operator*() const& ; -

      -

      - T & - optional<T&>::operator*() & ; -

      -

      - T & - optional<T&>::operator*() && ; -

      -
        -
      • - Requires: *this is initialized -
        • -
      • - Returns: The - reference contained. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted via - BOOST_ASSERT(). - On compilers that do not support ref-qualifiers on member functions these - three overloads are replaced with the classical two: a const - and non-const member functions. -
        • -
      • - Example: -
        T v ;
-T& vref = v ;
-optional<T&> opt ( vref );
-T const& vref2 = *opt;
-assert ( vref2 == v ) ;
-++ v ;
-assert ( *opt == v ) ;
-
        -
        • -
      -

      - space -

      -

      - T const& optional<T>::value() const& ; -

      -

      - T& - optional<T>::value() & ; -

      -

      - T&& - optional<T>::value() && ; -

      -
        -
      • - Returns: A reference to the contained - value, if *this - is initialized. -
        • -
      • - Throws: An instance of bad_optional_access, - if *this - is not initialized. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions these three overloads are replaced with - the classical two: a const - and non-const member functions. -
        • -
      • - Example: -
        T v ;
-optional<T> o0, o1 ( v );
-assert ( o1.value() == v );
-
-try {
-  o0.value(); // throws
-  assert ( false );
-}
-catch(bad_optional_access&) {
-  assert ( true );
-}
-
        - space -
        • -
      -

      - template<class U> T optional<T>::value_or(U && - v) const& ; -

      -

      - template<class U> T optional<T>::value_or(U && - v) && ; -

      -
        -
      • - Requires: T - is CopyConstructible. -
        • -
      • - Returns: First overload: bool(*this) ? **this : static_cast<T>(forward<U>(v)). - second overload: bool(*this) ? - std::move(**this) : - static_cast<T>(forward<U>(v)). -
        • -
      • - Throws: Any exception thrown by the selected - constructor of T. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions these three overloads are replaced with - the classical two: a const - and non-const member functions. - On compilers without rvalue reference support the type of v becomes U - const&. -
        • -
      -

      - space -

      -

      - T const& optional<T - (not a ref)>::get_value_or( - T const& default) const ; -

      -

      - T& - optional<T (not a ref)>::get_value_or( T& - default ) - ; -

      -

      - inline T - const& - get_optional_value_or ( - optional<T (not a ref)> const& o, T const& default ) ; -

      -

      - inline T& get_optional_value_or - ( optional<T - (not a ref)>& - o, T& default ) ; -

      -
        -
      • - Deprecated: Use value_or() instead. -
        • -
      • - Returns: A reference to the contained - value, if any, or default. -
        • -
      • - Throws: Nothing. -
        • -
      • - Example: -
        T v, z ;
-optional<T> def;
-T const& y = def.get_value_or(z);
-assert ( y == z ) ;
-
-optional<T> opt ( v );
-T const& u = get_optional_value_or(opt,z);
-assert ( u == v ) ;
-assert ( u != z ) ;
-
        -
        • -
      -

      - space -

      -

      - T const* optional<T - (not a ref)>::get_ptr() const ; -

      -

      - T* - optional<T (not a ref)>::get_ptr() ; -

      -

      - inline T - const* get_pointer ( - optional<T (not a ref)> const& ) ; -

      -

      - inline T* get_pointer - ( optional<T - (not a ref)> - &) ; -

      -
        -
      • - Returns: If *this is initialized, a pointer to the contained - value; else 0 (null). -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The contained value is permanently - stored within *this, - so you should not hold nor delete this pointer -
        • -
      • - Example: -
        T v;
-optional<T> opt(v);
-optional<T> const copt(v);
-T* p = opt.get_ptr() ;
-T const* cp = copt.get_ptr();
-assert ( p == get_pointer(opt) );
-assert ( cp == get_pointer(copt) ) ;
-
        -
        • -
      -

      - space -

      -

      - T const* optional<T - (not a ref)>::operator ->() - const ; -

      -

      - T* - optional<T (not a ref)>::operator ->() ; -

      -
        -
      • - Requires: *this is initialized. -
        • -
      • - Returns: A pointer to the contained value. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted via - BOOST_ASSERT(). -
        • -
      • - Example: -
        struct X { int mdata ; } ;
-X x ;
-optional<X> opt (x);
-opt->mdata = 2 ;
-
        -
        • -
      -

      - space -

      -

      - explicit optional<T>::operator bool() const ; -

      -
        -
      • - Returns: get_ptr() != 0. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: On compilers that do not support - explicit conversion operators this falls back to safe-bool idiom. -
        • -
      • - Example: -
        optional<T> def ;
-assert ( def == 0 );
-optional<T> opt ( v ) ;
-assert ( opt );
-assert ( opt != 0 );
-
        -
        • -
      -

      - space -

      -

      - bool optional<T>::operator!() noexcept ; -

      -
        -
      • - Returns: If *this is uninitialized, true; - else false. -
        • -
      • - Notes: This operator is provided for those - compilers which can't use the unspecified-bool-type operator - in certain boolean contexts. -
        • -
      • - Example: -
        optional<T> opt ;
-assert ( !opt );
-*opt = some_T ;
-
-// Notice the "double-bang" idiom here.
-assert ( !!opt ) ;
-
        -
        • -
      -

      - space -

      -

      - bool optional<T>::is_initialized() - const ; -

      -
      • - Deprecated: Same as explicit - operator bool - () ; -
      -

      - space -

      -

      - - Free - functions -

      -

      - space -

      -

      - optional<T (not a ref)> make_optional( T const& v ) -

      -
        -
      • - Returns: optional<T>(v) for the deduced type - T of v. -
        • -
      • - Example: -
        template<class T> void foo ( optional<T> const& opt ) ;
-
-foo ( make_optional(1+1) ) ; // Creates an optional<int>
-
        -
        • -
      -

      - space -

      -

      - optional<T (not a ref)> make_optional( bool condition, T const& v ) -

      -
        -
      • - Returns: optional<T>(condition,v) - for the deduced type T - of v. -
        • -
      • - Example: -
        optional<double> calculate_foo()
-{
-  double val = compute_foo();
-  return make_optional(is_not_nan_and_finite(val),val);
-}
-
-optional<double> v = calculate_foo();
-if ( !v )
-  error("foo wasn't computed");
-
        -
        • -
      -

      - space -

      -

      - bool operator - == ( optional<T> const& x, optional<T> - const& - y ); -

      -
        -
      • - Requires: T - shall meet requirements of EqualityComparable. -
        • -
      • - Returns: If both x - and y are initialized, - (*x - == *y). If - only x or y is initialized, false. - If both are uninitialized, true. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: Pointers have shallow relational - operators while optional - has deep relational operators. Do not use operator - == directly in generic code which - expect to be given either an optional<T> or a pointer; use equal_pointees() - instead -
        • -
      • - Example: -
        T x(12);
-T y(12);
-T z(21);
-optional<T> def0 ;
-optional<T> def1 ;
-optional<T> optX(x);
-optional<T> optY(y);
-optional<T> optZ(z);
-
-// Identity always hold
-assert ( def0 == def0 );
-assert ( optX == optX );
-
-// Both uninitialized compare equal
-assert ( def0 == def1 );
-
-// Only one initialized compare unequal.
-assert ( def0 != optX );
-
-// Both initialized compare as (*lhs == *rhs)
-assert ( optX == optY ) ;
-assert ( optX != optZ ) ;
-
        -
        • -
      -

      - space -

      -

      - bool operator - < ( optional<T> const& x, optional<T> - const& - y ); -

      -
        -
      • - Requires: T - shall meet requirements of LessThanComparable. -
        • -
      • - Returns: If y - is not initialized, false. - If y is initialized and - x is not initialized, - true. If both x and y - are initialized, (*x - < *y). -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: Pointers have shallow relational - operators while optional - has deep relational operators. Do not use operator - < directly in generic code which - expect to be given either an optional<T> or a pointer; use less_pointees() - instead. -
        • -
      • - Example: -
        T x(12);
-T y(34);
-optional<T> def ;
-optional<T> optX(x);
-optional<T> optY(y);
-
-// Identity always hold
-assert ( !(def < def) );
-assert ( optX == optX );
-
-// Both uninitialized compare equal
-assert ( def0 == def1 );
-
-// Only one initialized compare unequal.
-assert ( def0 != optX );
-
-// Both initialized compare as (*lhs == *rhs)
-assert ( optX == optY ) ;
-assert ( optX != optZ ) ;
-
        -
        • -
      -

      - space -

      -

      - bool operator - != ( optional<T> const& x, optional<T> - const& - y ); -

      -
        -
      • - Returns: !( - x == - y ); -
        • -
      • - Throws: Nothing. -
        • -
      -

      - space -

      -

      - bool operator - > ( optional<T> const& x, optional<T> - const& - y ); -

      -
        -
      • - Returns: ( - y < - x ); -
        • -
      • - Throws: Nothing. -
        • -
      -

      - space -

      -

      - bool operator - <= ( - optional<T> const& x, optional<T> - const& - y ); -

      -
        -
      • - Returns: !( - y < - x ); -
        • -
      • - Throws: Nothing. -
        • -
      -

      - space -

      -

      - bool operator - >= ( - optional<T> const& x, optional<T> - const& - y ); -

      -
        -
      • - Returns: !( - x<y ); -
        • -
      • - Throws: Nothing. -
        • -
      -

      - bool operator - == ( optional<T> const& x, none_t - ) noexcept; -

      -
        -
      • - Returns: !x. -
        • -
      • - Notes: T - need not meet requirements of EqualityComparable. -
        • -
      -

      - space -

      -

      - bool operator - != ( optional<T> const& x, none_t - ) noexcept; -

      -
      • - Returns: !( - x == - y ); -
      -

      - space -

      -

      - void swap - ( optional<T>& - x, optional<T>& y ) ; -

      -
        -
      • - Effect: If both x - and y are initialized, - calls swap(*x,*y) using std::swap. - If only one is initialized, say x, - calls: y.reset(*x); x.reset(); If none is initialized, does nothing. -
        • -
      • - Postconditions: The states of x and y - interchanged. -
        • -
      • - Throws: If both are initialized, whatever - swap(T&,T&) - throws. If only one is initialized, whatever T::T ( T&& - ) throws. -
        • -
      • - Notes: If both are initialized, swap(T&,T&) - is used unqualified but with std::swap - introduced in scope. If only one is initialized, T::~T() and T::T( - T&& - ) is called. -
        • -
      • - Exception Safety: If both are initialized, - this operation has the exception safety guarantees of swap(T&,T&). - If only one is initialized, it has the same basic guarantee as optional<T>::operator= ( T&& - ). -
        • -
      • - Example: -
        T x(12);
-T y(21);
-optional<T> def0 ;
-optional<T> def1 ;
-optional<T> optX(x);
-optional<T> optY(y);
-
-boost::swap(def0,def1); // no-op
-
-boost::swap(def0,optX);
-assert ( *def0 == x );
-assert ( !optX );
-
-boost::swap(def0,optX); // Get back to original values
-
-boost::swap(optX,optY);
-assert ( *optX == y );
-assert ( *optY == x );
-
        -
        • -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/development.html b/doc/html/boost_optional/development.html deleted file mode 100644 index 21e6db44..00000000 --- a/doc/html/boost_optional/development.html +++ /dev/null @@ -1,412 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      -
      The models
      -
      The semantics
      -
      The Interface
      -
      -
      -
      -

      - In C++, we can declare an object (a variable) of type - T, and we can give this variable - an initial value (through an initializer. - (cf. 8.5)). When a declaration includes a non-empty initializer (an initial - value is given), it is said that the object has been initialized. If the - declaration uses an empty initializer (no initial value is given), and neither - default nor value initialization applies, it is said that the object is - uninitialized. Its actual value exist but - has an indeterminate initial value (cf. 8.5/11). optional<T> intends - to formalize the notion of initialization (or lack of it) allowing a program - to test whether an object has been initialized and stating that access to - the value of an uninitialized object is undefined behavior. That is, when - a variable is declared as optional<T> - and no initial value is given, the variable is formally - uninitialized. A formally uninitialized optional object has conceptually - no value at all and this situation can be tested at runtime. It is formally - undefined behavior to try to access the value of an - uninitialized optional. An uninitialized optional can be assigned a value, - in which case its initialization state changes to initialized. Furthermore, - given the formal treatment of initialization states in optional objects, - it is even possible to reset an optional to uninitialized. -

      -

      - In C++ there is no formal notion of uninitialized objects, which means that - objects always have an initial value even if indeterminate. As discussed - on the previous section, this has a drawback because you need additional - information to tell if an object has been effectively initialized. One of - the typical ways in which this has been historically dealt with is via a - special value: EOF, npos, -1, etc... This is equivalent to - adding the special value to the set of possible values of a given type. This - super set of T plus some - nil_t—where nil_t - is some stateless POD—can be modeled in modern languages as a discriminated union of T and nil_t. Discriminated - unions are often called variants. A variant has a current - type, which in our case is either T - or nil_t. Using the Boost.Variant library, this model - can be implemented in terms of boost::variant<T,nil_t>. - There is precedent for a discriminated union as a model for an optional value: - the Haskell Maybe - built-in type constructor. Thus, a discriminated union T+nil_t - serves as a conceptual foundation. -

      -

      - A variant<T,nil_t> follows naturally from the traditional - idiom of extending the range of possible values adding an additional sentinel - value with the special meaning of Nothing. However, - this additional Nothing value is largely irrelevant - for our purpose since our goal is to formalize the notion of uninitialized - objects and, while a special extended value can be used to convey that meaning, - it is not strictly necessary in order to do so. -

      -

      - The observation made in the last paragraph about the irrelevant nature of - the additional nil_t with - respect to purpose of optional<T> suggests - an alternative model: a container that either has a - value of T or nothing. -

      -

      - As of this writing I don't know of any precedent for a variable-size fixed-capacity - (of 1) stack-based container model for optional values, yet I believe this - is the consequence of the lack of practical implementations of such a container - rather than an inherent shortcoming of the container model. -

      -

      - In any event, both the discriminated-union or the single-element container - models serve as a conceptual ground for a class representing optional—i.e. - possibly uninitialized—objects. For instance, these models show the exact - semantics required for a wrapper of optional values: -

      -

      - Discriminated-union: -

      -
        -
      • - deep-copy semantics: copies of the variant - implies copies of the value. -
        • -
      • - deep-relational semantics: comparisons - between variants matches both current types and values -
        • -
      • - If the variant's current type is T, - it is modeling an initialized optional. -
        • -
      • - If the variant's current type is not T, - it is modeling an uninitialized optional. -
        • -
      • - Testing if the variant's current type is T - models testing if the optional is initialized -
        • -
      • - Trying to extract a T - from a variant when its current type is not T, - models the undefined behavior of trying to access the value of an uninitialized - optional -
        • -
      -

      - Single-element container: -

      -
        -
      • - deep-copy semantics: copies of the container - implies copies of the value. -
        • -
      • - deep-relational semantics: comparisons - between containers compare container size and if match, contained value -
        • -
      • - If the container is not empty (contains an object of type T), it is modeling an initialized - optional. -
        • -
      • - If the container is empty, it is modeling an uninitialized - optional. -
        • -
      • - Testing if the container is empty models testing if the optional is initialized -
        • -
      • - Trying to extract a T - from an empty container models the undefined behavior of trying to access - the value of an uninitialized optional -
        • -
      -
      -
      -
      -

      - Objects of type optional<T> - are intended to be used in places where objects of type T - would but which might be uninitialized. Hence, optional<T>'s - purpose is to formalize the additional possibly uninitialized state. From - the perspective of this role, optional<T> - can have the same operational semantics of T - plus the additional semantics corresponding to this special state. As such, - optional<T> could - be thought of as a supertype of T. - Of course, we can't do that in C++, so we need to compose the desired semantics - using a different mechanism. Doing it the other way around, that is, making - optional<T> a - subtype of T - is not only conceptually wrong but also impractical: it is not allowed to - derive from a non-class type, such as a built-in type. -

      -

      - We can draw from the purpose of optional<T> - the required basic semantics: -

      -
        -
      • - Default Construction: To introduce a - formally uninitialized wrapped object. -
        • -
      • - Direct Value Construction via copy: - To introduce a formally initialized wrapped object whose value is obtained - as a copy of some object. -
        • -
      • - Deep Copy Construction: To obtain a - new yet equivalent wrapped object. -
        • -
      • - Direct Value Assignment (upon initialized): - To assign a value to the wrapped object. -
        • -
      • - Direct Value Assignment (upon uninitialized): - To initialize the wrapped object with a value obtained as a copy of some - object. -
        • -
      • - Assignment (upon initialized): To assign - to the wrapped object the value of another wrapped object. -
        • -
      • - Assignment (upon uninitialized): To - initialize the wrapped object with value of another wrapped object. -
        • -
      • - Deep Relational Operations (when supported by the - type T): To compare wrapped object values taking into account - the presence of uninitialized states. -
        • -
      • - Value access: To unwrap the wrapped - object. -
        • -
      • - Initialization state query: To determine - if the object is formally initialized or not. -
        • -
      • - Swap: To exchange wrapped objects. (with - whatever exception safety guarantees are provided by T's - swap). -
        • -
      • - De-initialization: To release the wrapped - object (if any) and leave the wrapper in the uninitialized state. -
        • -
      -

      - Additional operations are useful, such as converting constructors and converting - assignments, in-place construction and assignment, and safe value access - via a pointer to the wrapped object or null. -

      -
      -
      -
      -

      - Since the purpose of optional is to allow us to use objects with a formal - uninitialized additional state, the interface could try to follow the interface - of the underlying T type - as much as possible. In order to choose the proper degree of adoption of - the native T interface, the - following must be noted: Even if all the operations supported by an instance - of type T are defined for - the entire range of values for such a type, an optional<T> - extends such a set of values with a new value for which most (otherwise valid) - operations are not defined in terms of T. -

      -

      - Furthermore, since optional<T> - itself is merely a T wrapper - (modeling a T supertype), - any attempt to define such operations upon uninitialized optionals will be - totally artificial w.r.t. T. -

      -

      - This library chooses an interface which follows from T's - interface only for those operations which are well defined (w.r.t the type - T) even if any of the operands - are uninitialized. These operations include: construction, copy-construction, - assignment, swap and relational operations. -

      -

      - For the value access operations, which are undefined (w.r.t the type T) when the operand is uninitialized, a - different interface is chosen (which will be explained next). -

      -

      - Also, the presence of the possibly uninitialized state requires additional - operations not provided by T - itself which are supported by a special interface. -

      -
      - - Lexically-hinted - Value Access in the presence of possibly uninitialized optional objects: The - operators * and -> -
      -

      - A relevant feature of a pointer is that it can have a null - pointer value. This is a special value which - is used to indicate that the pointer is not referring to any object at all. - In other words, null pointer values convey the notion of nonexistent objects. -

      -

      - This meaning of the null pointer value allowed pointers to became a de - facto standard for handling optional objects because all you have - to do to refer to a value which you don't really have is to use a null pointer - value of the appropriate type. Pointers have been used for decades—from - the days of C APIs to modern C++ libraries—to refer - to optional (that is, possibly nonexistent) objects; particularly as optional - arguments to a function, but also quite often as optional data members. -

      -

      - The possible presence of a null pointer value makes the operations that access - the pointee's value possibly undefined, therefore, expressions which use - dereference and access operators, such as: ( - *p = 2 ) - and ( p->foo() ), implicitly - convey the notion of optionality, and this information is tied to the syntax - of the expressions. That is, the presence of operators * - and -> tell by themselves - —without any additional context— that the expression will be undefined - unless the implied pointee actually exist. -

      -

      - Such a de facto idiom for referring to optional objects - can be formalized in the form of a concept: the OptionalPointee - concept. This concept captures the syntactic usage of operators *, -> - and contextual conversion to bool - to convey the notion of optionality. -

      -

      - However, pointers are good to refer - to optional objects, but not particularly good to handle the optional objects - in all other respects, such as initializing or moving/copying them. The problem - resides in the shallow-copy of pointer semantics: if you need to effectively - move or copy the object, pointers alone are not enough. The problem is that - copies of pointers do not imply copies of pointees. For example, as was discussed - in the motivation, pointers alone cannot be used to return optional objects - from a function because the object must move outside from the function and - into the caller's context. -

      -

      - A solution to the shallow-copy problem that is often used is to resort to - dynamic allocation and use a smart pointer to automatically handle the details - of this. For example, if a function is to optionally return an object X, it can use shared_ptr<X> - as the return value. However, this requires dynamic allocation of X. If X - is a built-in or small POD, this technique is very poor in terms of required - resources. Optional objects are essentially values so it is very convenient - to be able to use automatic storage and deep-copy semantics to manipulate - optional values just as we do with ordinary values. Pointers do not have - this semantics, so are inappropriate for the initialization and transport - of optional values, yet are quite convenient for handling the access to the - possible undefined value because of the idiomatic aid present in the OptionalPointee concept - incarnated by pointers. -

      -
      - - Optional<T> - as a model of OptionalPointee -
      -

      - For value access operations optional<> uses operators * - and -> to lexically warn - about the possibly uninitialized state appealing to the familiar pointer - semantics w.r.t. to null pointers. -

      -
      - - - - - -
      [Warning]Warning

      - However, it is particularly important to note that optional<> objects are not pointers. optional<> is not, and does not model, a pointer. -

      -

      - For instance, optional<> - does not have shallow-copy so does not alias: two different optionals never - refer to the same value unless T - itself is a reference (but may have equivalent values). - The difference between an optional<T> - and a pointer must be kept in mind, particularly because the semantics of - relational operators are different: since optional<T> - is a value-wrapper, relational operators are deep: they compare optional - values; but relational operators for pointers are shallow: they do not compare - pointee values. As a result, you might be able to replace optional<T> - by T* - on some situations but not always. Specifically, on generic code written - for both, you cannot use relational operators directly, and must use the - template functions equal_pointees() - and less_pointees() - instead. -

      -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/discussion.html b/doc/html/boost_optional/discussion.html deleted file mode 100644 index d17a70e8..00000000 --- a/doc/html/boost_optional/discussion.html +++ /dev/null @@ -1,128 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Consider these functions which should return a value but which might not have - a value to return: -

      -
        -
      • - (A) double sqrt(double n ); -
        • -
      • - (B) char get_async_input(); -
        • -
      • - (C) point polygon::get_any_point_effectively_inside(); -
        • -
      -

      - There are different approaches to the issue of not having a value to return. -

      -

      - A typical approach is to consider the existence of a valid return value as - a postcondition, so that if the function cannot compute the value to return, - it has either undefined behavior (and can use assert in a debug build) or uses - a runtime check and throws an exception if the postcondition is violated. This - is a reasonable choice for example, for function (A), because the lack of a - proper return value is directly related to an invalid parameter (out of domain - argument), so it is appropriate to require the callee to supply only parameters - in a valid domain for execution to continue normally. -

      -

      - However, function (B), because of its asynchronous nature, does not fail just - because it can't find a value to return; so it is incorrect to consider such - a situation an error and assert or throw an exception. This function must return, - and somehow, must tell the callee that it is not returning a meaningful value. -

      -

      - A similar situation occurs with function (C): it is conceptually an error to - ask a null-area polygon to return a point inside itself, - but in many applications, it is just impractical for performance reasons to - treat this as an error (because detecting that the polygon has no area might - be too expensive to be required to be tested previously), and either an arbitrary - point (typically at infinity) is returned, or some efficient way to tell the - callee that there is no such point is used. -

      -

      - There are various mechanisms to let functions communicate that the returned - value is not valid. One such mechanism, which is quite common since it has - zero or negligible overhead, is to use a special value which is reserved to - communicate this. Classical examples of such special values are EOF, string::npos, points - at infinity, etc... -

      -

      - When those values exist, i.e. the return type can hold all meaningful values - plus the signal value, this mechanism - is quite appropriate and well known. Unfortunately, there are cases when such - values do not exist. In these cases, the usual alternative is either to use - a wider type, such as int in place - of char; or a compound type, such - as std::pair<point,bool>. -

      -

      - Returning a std::pair<T,bool>, thus attaching a boolean flag to the result - which indicates if the result is meaningful, has the advantage that can be - turned into a consistent idiom since the first element of the pair can be whatever - the function would conceptually return. For example, the last two functions - could have the following interface: -

      -
      std::pair<char,bool> get_async_input();
-std::pair<point,bool> polygon::get_any_point_effectively_inside();
-
      -

      - These functions use a consistent interface for dealing with possibly nonexistent - results: -

      -
      std::pair<point,bool> p = poly.get_any_point_effectively_inside();
-if ( p.second )
-    flood_fill(p.first);
-
      -

      - However, not only is this quite a burden syntactically, it is also error prone - since the user can easily use the function result (first element of the pair) - without ever checking if it has a valid value. -

      -

      - Clearly, we need a better idiom. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/examples.html b/doc/html/boost_optional/examples.html deleted file mode 100644 index 64a95a97..00000000 --- a/doc/html/boost_optional/examples.html +++ /dev/null @@ -1,147 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      -
      Optional - return values
      -
      Optional - local variables
      -
      Optional - data members
      -
      Bypassing - expensive unnecessary default construction
      -
      -
      -
      -
      optional<char> get_async_input()
-{
-    if ( !queue.empty() )
-        return optional<char>(queue.top());
-    else return optional<char>(); // uninitialized
-}
-
-void receive_async_message()
-{
-    optional<char> rcv ;
-    // The safe boolean conversion from 'rcv' is used here.
-    while ( (rcv = get_async_input()) && !timeout() )
-        output(*rcv);
-}
-
      -
      -
      -
      -
      optional<string> name ;
-if ( database.open() )
-{
-    name = database.lookup(employer_name) ;
-}
-else
-{
-    if ( can_ask_user )
-        name = user.ask(employer_name) ;
-}
-
-if ( name )
-    print(*name);
-else print("employer's name not found!");
-
      -
      -
      -
      -
      class figure
-{
-    public:
-
-    figure()
-    {
-        // data member 'm_clipping_rect' is uninitialized at this point.
-    }
-
-    void clip_in_rect ( rect const& rect )
-    {
-        ....
-        m_clipping_rect = rect ; // initialized here.
-    }
-
-    void draw ( canvas& cvs )
-    {
-        if ( m_clipping_rect )
-            do_clipping(*m_clipping_rect);
-
-        cvs.drawXXX(..);
-    }
-
-    // this can return NULL.
-    rect const* get_clipping_rect() { return get_pointer(m_clipping_rect); }
-
-    private :
-
-    optional<rect> m_clipping_rect ;
-
-};
-
      -
      -
      -
      -
      class ExpensiveCtor { ... } ;
-class Fred
-{
-    Fred() : mLargeVector(10000) {}
-
-    std::vector< optional<ExpensiveCtor> > mLargeVector ;
-} ;
-
      -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/exception_safety_guarantees.html b/doc/html/boost_optional/exception_safety_guarantees.html deleted file mode 100644 index 3cb8b153..00000000 --- a/doc/html/boost_optional/exception_safety_guarantees.html +++ /dev/null @@ -1,170 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - This library assumes that T's - destructor does not throw exceptions. If it does, the behaviour of many operations - on optional<T> is - undefined. -

      -

      - The following mutating operations never throw exceptions: -

      -
        -
      • - optional<T>::operator= ( none_t ) noexcept -
        • -
      • - optional<T>::reset() noexcept -
        • -
      -

      - In addition, the following constructors and the destructor never throw exceptions: -

      -
        -
      • - optional<T>::optional() - noexcept -
        • -
      • - optional<T>::optional( none_t ) noexcept -
        • -
      -

      - Regarding the following assignment functions: -

      -
        -
      • - optional<T>::operator= ( optional<T> const& ) -
        • -
      • - optional<T>::operator= ( T const& ) -
        • -
      • - template<class U> optional<T>::operator= ( optional<U> const& ) -
        • -
      • - template<class InPlaceFactory> optional<T>::operator= ( InPlaceFactory - const& - ) -
        • -
      • - template<class TypedInPlaceFactory> optional<T>::operator= ( TypedInPlaceFactory - const& - ) -
        • -
      • - optional<T>::reset( T const& ) -
        • -
      -

      - They forward calls to the corresponding T's - constructors or assignments (depending on whether the optional object is initialized - or not); so if both T's constructor - and the assignment provide strong exception safety guarantee, optional<T>'s assignment - also provides strong exception safety guarantee; otherwise we only get the - basic guarantee. Additionally, if both involved T's - constructor and the assignment never throw, optional<T>'s - assignment also never throws. -

      -

      - Unless T's constructor or assignment - throws, assignments to optional<T> - do not throw anything else on its own. A throw during assignment never changes - the initialization state of any optional object involved: -

      -
      optional<T> opt1(val1);
-optional<T> opt2(val2);
-assert(opt1);
-assert(opt2);
-
-try
-{
-  opt1 = opt2; // throws
-}
-catch(...)
-{
-  assert(opt1);
-  assert(opt2);
-}
-
      -

      - This also applies to move assignments/constructors. However, move operations - are made no-throw more often. -

      -

      - Operation emplace provides - basic exception safety guarantee. If it throws, the optional object becomes - uninitialized regardless of its initial state, and its previous contained value - (if any) is destroyed. It doesn't call any assignment or move/copy constructor - on T. -

      -

      - - Swap -

      -

      - Unless swap on optional is - customized, its primary implementation forwards calls to T's - swap or move constructor (depending - on the initialization state of the optional objects). Thus, if both T's swap - and move constructor never throw, swap - on optional<T> never - throws. similarly, if both T's - swap and move constructor offer - strong guarantee, swap on - optional<T> also - offers a strong guarantee. -

      -

      - In case swap on optional is - customized, the call to T's - move constructor are replaced with the calls to T's - default constructor followed by swap. - (This is more useful on older compilers that do not support move semantics, - when one wants to achieve stronger exception safety guarantees.) In this case - the exception safety guarantees for swap - are reliant on the guarantees of T's - swap and default constructor -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/implementation_notes.html b/doc/html/boost_optional/implementation_notes.html deleted file mode 100644 index 48d476cd..00000000 --- a/doc/html/boost_optional/implementation_notes.html +++ /dev/null @@ -1,55 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - optional<T> is - currently implemented using a custom aligned storage facility built from alignment_of and type_with_alignment - (both from Type Traits). It uses a separate boolean flag to indicate the initialization - state. Placement new with T's - copy/move constructor and T's - destructor are explicitly used to initialize, copy, move and destroy optional - values. As a result, T's default - constructor is effectively by-passed, but the exception guarantees are basic. - It is planned to replace the current implementation with another with stronger - exception safety, such as a future boost::variant. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/in_place_factories.html b/doc/html/boost_optional/in_place_factories.html deleted file mode 100644 index 1cc1e05f..00000000 --- a/doc/html/boost_optional/in_place_factories.html +++ /dev/null @@ -1,196 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - One of the typical problems with wrappers and containers is that their interfaces - usually provide an operation to initialize or assign the contained object as - a copy of some other object. This not only requires the underlying type to - be Copy Constructible, - but also requires the existence of a fully constructed object, often temporary, - just to follow the copy from: -

      -
      struct X
-{
-    X ( int, std::string ) ;
-} ;
-
-class W
-{
-    X wrapped_ ;
-
-    public:
-
-    W ( X const& x ) : wrapped_(x) {}
-} ;
-
-void foo()
-{
-    // Temporary object created.
-    W ( X(123,"hello") ) ;
-}
-
      -

      - A solution to this problem is to support direct construction of the contained - object right in the container's storage. In this scheme, the user only needs - to supply the arguments to the constructor to use in the wrapped object construction. -

      -
      class W
-{
-    X wrapped_ ;
-
-    public:
-
-    W ( X const& x ) : wrapped_(x) {}
-    W ( int a0, std::string a1) : wrapped_(a0,a1) {}
-} ;
-
-void foo()
-{
-    // Wrapped object constructed in-place
-    // No temporary created.
-    W (123,"hello") ;
-}
-
      -

      - A limitation of this method is that it doesn't scale well to wrapped objects - with multiple constructors nor to generic code were the constructor overloads - are unknown. -

      -

      - The solution presented in this library is the family of InPlaceFactories - and TypedInPlaceFactories. These factories - are a family of classes which encapsulate an increasing number of arbitrary - constructor parameters and supply a method to construct an object of a given - type using those parameters at an address specified by the user via placement - new. -

      -

      - For example, one member of this family looks like: -

      -
      template<class T,class A0, class A1>
-class TypedInPlaceFactory2
-{
-    A0 m_a0 ; A1 m_a1 ;
-
-    public:
-
-    TypedInPlaceFactory2( A0 const& a0, A1 const& a1 ) : m_a0(a0), m_a1(a1) {}
-
-    void construct ( void* p ) { new (p) T(m_a0,m_a1) ; }
- } ;
-
      -

      - A wrapper class aware of this can use it as: -

      -
      class W
-{
-    X wrapped_ ;
-
-    public:
-
-    W ( X const& x ) : wrapped_(x) {}
-    W ( TypedInPlaceFactory2 const& fac ) { fac.construct(&wrapped_) ; }
-} ;
-
-void foo()
-{
-    // Wrapped object constructed in-place via a TypedInPlaceFactory.
-    // No temporary created.
-    W ( TypedInPlaceFactory2<X,int,std::string>(123,"hello")) ;
-}
-
      -

      - The factories are divided in two groups: -

      -
        -
      • - TypedInPlaceFactories: those which - take the target type as a primary template parameter. -
        • -
      • - InPlaceFactories: those with a template - construct(void*) member - function taking the target type. -
        • -
      -

      - Within each group, all the family members differ only in the number of parameters - allowed. -

      -

      - This library provides an overloaded set of helper template functions to construct - these factories without requiring unnecessary template parameters: -

      -
      template<class A0,...,class AN>
-InPlaceFactoryN <A0,...,AN> in_place ( A0 const& a0, ..., AN const& aN) ;
-
-template<class T,class A0,...,class AN>
-TypedInPlaceFactoryN <T,A0,...,AN> in_place ( T const& a0, A0 const& a0, ..., AN const& aN) ;
-
      -

      - In-place factories can be used generically by the wrapper and user as follows: -

      -
      class W
-{
-    X wrapped_ ;
-
-    public:
-
-    W ( X const& x ) : wrapped_(x) {}
-
-    template< class InPlaceFactory >
-    W ( InPlaceFactory const& fac ) { fac.template <X>construct(&wrapped_) ; }
-
-} ;
-
-void foo()
-{
-    // Wrapped object constructed in-place via a InPlaceFactory.
-    // No temporary created.
-    W ( in_place(123,"hello") ) ;
-}
-
      -

      - The factories are implemented in the headers: in_place_factory.hpp - and typed_in_place_factory.hpp -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/motivation.html b/doc/html/boost_optional/motivation.html deleted file mode 100644 index ee00899c..00000000 --- a/doc/html/boost_optional/motivation.html +++ /dev/null @@ -1,128 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Consider these functions which should return a value but which might not have - a value to return: -

      -
        -
      • - (A) double sqrt(double n ); -
        • -
      • - (B) char get_async_input(); -
        • -
      • - (C) point polygon::get_any_point_effectively_inside(); -
        • -
      -

      - There are different approaches to the issue of not having a value to return. -

      -

      - A typical approach is to consider the existence of a valid return value as - a postcondition, so that if the function cannot compute the value to return, - it has either undefined behavior (and can use assert in a debug build) or uses - a runtime check and throws an exception if the postcondition is violated. This - is a reasonable choice for example, for function (A), because the lack of a - proper return value is directly related to an invalid parameter (out of domain - argument), so it is appropriate to require the callee to supply only parameters - in a valid domain for execution to continue normally. -

      -

      - However, function (B), because of its asynchronous nature, does not fail just - because it can't find a value to return; so it is incorrect to consider such - a situation an error and assert or throw an exception. This function must return, - and somehow, must tell the callee that it is not returning a meaningful value. -

      -

      - A similar situation occurs with function (C): it is conceptually an error to - ask a null-area polygon to return a point inside itself, - but in many applications, it is just impractical for performance reasons to - treat this as an error (because detecting that the polygon has no area might - be too expensive to be required to be tested previously), and either an arbitrary - point (typically at infinity) is returned, or some efficient way to tell the - callee that there is no such point is used. -

      -

      - There are various mechanisms to let functions communicate that the returned - value is not valid. One such mechanism, which is quite common since it has - zero or negligible overhead, is to use a special value which is reserved to - communicate this. Classical examples of such special values are EOF, string::npos, points - at infinity, etc... -

      -

      - When those values exist, i.e. the return type can hold all meaningful values - plus the signal value, this mechanism - is quite appropriate and well known. Unfortunately, there are cases when such - values do not exist. In these cases, the usual alternative is either to use - a wider type, such as int in place - of char; or a compound type, such - as std::pair<point,bool>. -

      -

      - Returning a std::pair<T,bool>, thus attaching a boolean flag to the result - which indicates if the result is meaningful, has the advantage that can be - turned into a consistent idiom since the first element of the pair can be whatever - the function would conceptually return. For example, the last two functions - could have the following interface: -

      -
      std::pair<char,bool> get_async_input();
-std::pair<point,bool> polygon::get_any_point_effectively_inside();
-
      -

      - These functions use a consistent interface for dealing with possibly nonexistent - results: -

      -
      std::pair<point,bool> p = poly.get_any_point_effectively_inside();
-if ( p.second )
-    flood_fill(p.first);
-
      -

      - However, not only is this quite a burden syntactically, it is also error prone - since the user can easily use the function result (first element of the pair) - without ever checking if it has a valid value. -

      -

      - Clearly, we need a better idiom. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/optional_references.html b/doc/html/boost_optional/optional_references.html deleted file mode 100644 index 5ff61bf8..00000000 --- a/doc/html/boost_optional/optional_references.html +++ /dev/null @@ -1,114 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - This library allows the template parameter T - to be of reference type: T&, and to some extent, T - const&. -

      -

      - However, since references are not real objects some restrictions apply and - some operations are not available in this case: -

      -
        -
      • - Converting constructors -
        • -
      • - Converting assignment -
        • -
      • - InPlace construction -
        • -
      • - InPlace assignment -
        • -
      • - Value-access via pointer -
        • -
      -

      - Also, even though optional<T&> - treats it wrapped pseudo-object much as a real value, a true real reference - is stored so aliasing will occur: -

      -
        -
      • - Copies of optional<T&> - will copy the references but all these references will nonetheless refer - to the same object. -
        • -
      • - Value-access will actually provide access to the referenced object rather - than the reference itself. -
        • -
      -
      - - - - - -
      [Warning]Warning

      - On compilers that do not conform to Standard C++ rules of reference binding, - operations on optional references might give adverse results: rather than - binding a reference to a designated object they may create an unexpected - temporary and bind to it. For more details see Dependencies - and Portability section. -

      -

      - - Rvalue - references -

      -

      - Rvalue references and lvalue references to const have the ability in C++ to - extend the life time of a temporary they bind to. Optional references do not - have this capability, therefore to avoid surprising effects it is not possible - to initialize an optional references from a temporary. Optional rvalue references - are disabled altogether. Also, the initialization and assignment of an optional - reference to const from rvalue reference is disabled. -

      -
      const int& i = 1;            // legal
-optional<const int&> oi = 1; // illegal
-
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/quick_start.html b/doc/html/boost_optional/quick_start.html deleted file mode 100644 index 0388d430..00000000 --- a/doc/html/boost_optional/quick_start.html +++ /dev/null @@ -1,169 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      -
      Optional - return values
      -
      Optional - automatic variables
      -
      Optional - data members
      -
      Bypassing - unnecessary default construction
      -
      Storage - in containers
      -
      -
      -
      -

      - Let's write and use a converter function that converts a std::string - to an int. It is possible that - for a given string (e.g. "cat") - there exists no value of type int - capable of representing the conversion result. We do not consider such situation - an error. We expect that the converter can be used only to check if the conversion - is possible. A natural signature for this function can be: -

      -
      #include <boost/optional.hpp>
-boost::optional<int> convert(const std::string& text);
-
      -

      - All necessary functionality can be included with one header <boost/optional.hpp>. - The above function signature means that the function can either return a - value of type int or a flag - indicating that no value of int - is available. This does not indicate an error. It is like one additional - value of int. This is how we - can use our function: -

      -
      const std::string& text = /*... */;
-boost::optional<int> oi = convert(text); // move-construct
-if (oi)                                  // contextual conversion to bool
-  int i = *oi;                           // operator*
-
      -

      - In order to test if optional - contains a value, we use the contextual conversion to type bool. Because of this we can combine the initialization - of the optional object and the test into one instruction: -

      -
      if (boost::optional<int> oi = convert(text))
-  int i = *oi;
-
      -

      - We extract the contained value with operator* (and with operator-> where it makes sense). An attempt to - extract the contained value of an uninitialized optional object is an undefined - behaviour (UB). This implementation guards the call with BOOST_ASSERT. Therefore you should be sure - that the contained value is there before extracting. For instance, the following - code is reasonably UB-safe: -

      -
      int i = *convert("100");
-
      -

      - This is because we know that string value "100" - converts to a valid value of int. - If you do not like this potential UB, you can use an alternative way of extracting - the contained value: -

      -
      try {
-  int j = convert(text).value();
-}
-catch (const boost::bad_optional_access&) {
-  // deal with it
-}
-
      -

      - This version throws an exception upon an attempt to access a nonexistent - contained value. If your way of dealing with the missing value is to use - some default, like 0, there exists - a yet another alternative: -

      -
      int k = convert(text).value_or(0);
-
      -

      - This uses the atoi-like approach - to conversions: if text does - not represent an integral number just return 0. - Finally, you can provide a callback to be called when trying to access the - contained value fails: -

      -
      int fallback_to_default()
-{
-  cerr << "could not convert; using -1 instead" << endl;
-  return -1;
-}
-
-int l = convert(text).value_or_eval(fallback_to_default);
-
      -

      - This will call the provided callback and return whatever the callback returns. - The callback can have side effects: they will only be observed when the optional - object does not contain a value. -

      -

      - Now, let's consider how function convert - can be implemented. -

      -
      boost::optional<int> convert(const std::string& text)
-{
-  std::stringstream s(text);
-  int i;
-  if ((s >> i) && s.get() == std::char_traits<char>::eof())
-    return i;
-  else
-    return boost::none;
-}
-
      -

      - Observe the two return statements. return - i uses the converting constructor - that can create optional<T> - from T. Thus constructed - optional object is initialized and its value is a copy of i. - The other return statement uses another converting constructor from a special - tag boost::none. It is used to indicate that we want - to create an uninitialized optional object. -

      -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html b/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html deleted file mode 100644 index b49c8abe..00000000 --- a/doc/html/boost_optional/quick_start/bypassing_unnecessary_default_construction.html +++ /dev/null @@ -1,75 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Suppose we have class Date, - which does not have a default constructor: there is no good candidate for - a default date. We have a function that returns two dates in form of a boost::tuple: -

      -
      boost::tuple<Date, Date> getPeriod();
-
      -

      - In other place we want to use the result of getPeriod, - but want the two dates to be named: begin - and end. We want to implement - something like 'multiple return values': -

      -
      Date begin, end; // Error: no default ctor!
-boost::tie(begin, end) = getPeriod();
-
      -

      - The second line works already, this is the capability of Boost.Tuple - library, but the first line won't work. We could set some invented initial - dates, but it is confusing and may be an unacceptable cost, given that these - values will be overwritten in the next line anyway. This is where optional can help: -

      -
      boost::optional<Date> begin, end;
-boost::tie(begin, end) = getPeriod();
-
      -

      - It works because inside boost::tie a - move-assignment from T is - invoked on optional<T>, - which internally calls a move-constructor of T. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/quick_start/optional_automatic_variables.html b/doc/html/boost_optional/quick_start/optional_automatic_variables.html deleted file mode 100644 index e4bf47a1..00000000 --- a/doc/html/boost_optional/quick_start/optional_automatic_variables.html +++ /dev/null @@ -1,75 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - We could write function convert - in a slightly different manner, so that it has a single return-statement: -

      -
      boost::optional<int> convert(const std::string& text)
-{
-  boost::optional<int> ans;
-  std::stringstream s(text);
-  int i;
-  if ((s >> i) && s.get() == std::char_traits<char>::eof())
-    ans = i;
-
-  return ans;
-}
-
      -

      - The default constructor of optional - creates an uninitialized optional object. Unlike with ints - you cannot have an optional<int> - in an indeterminate state. Its state is always well defined. Instruction - ans = - i initializes the optional object. - It uses the 'mixed' assignment from int. - In general, for optional<T>, - when an assignment from T - is invoked, it can do two things. If the optional object is not initialized - (our case here), it initializes the contained value using T's - copy constructor. If the optional object is already initialized, it assigns - the new value to it using T's - copy assignment. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/quick_start/optional_data_members.html b/doc/html/boost_optional/quick_start/optional_data_members.html deleted file mode 100644 index 32684053..00000000 --- a/doc/html/boost_optional/quick_start/optional_data_members.html +++ /dev/null @@ -1,94 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Suppose we want to implement a lazy load optimization. - This is because we do not want to perform an expensive initialization of - our Resource until (if at - all) it is really used. We can do it this way: -

      -
      class Widget
-{
-  mutable boost::optional<const Resource> resource_;
-
-public:
-  Widget() {}
-
-  const Resource& getResource() const // not thread-safe
-  {
-    if (resource_ == boost::none)
-        resource_.emplace("resource", "arguments");
-
-    return *resource_;
-  }
-};
-
      -

      - optional's default constructor - creates an uninitialized optional. No call to Resource's - default constructor is attempted. Resource - doesn't have to be DefaultConstructible. In function - getResource we first check - if resource_ is initialized. - This time we do not use the contextual conversion to bool, - but a comparison with boost::none. - These two ways are equivalent. Function emplace - initializes the optional in-place by perfect-forwarding the arguments to - the constructor of Resource. - No copy- or move-construction is involved here. Resource - doesn't even have to be MoveConstructible. -

      -
      - - - - - -
      [Note]Note

      - Function emplace is only - available on compilers that support rvalue references and variadic templates. - If your compiler does not support these features and you still need to - avoid any move-constructions, use In-Place - Factories. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/quick_start/optional_return_values.html b/doc/html/boost_optional/quick_start/optional_return_values.html deleted file mode 100644 index b9953e7e..00000000 --- a/doc/html/boost_optional/quick_start/optional_return_values.html +++ /dev/null @@ -1,135 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Let's write and use a converter function that converts an a std::string - to an int. It is possible that - for a given string (e.g. "cat") - there exist no value of type int - capable of representing the conversion result. We do not consider such situation - an error. We expect that the converter can be used only to check if the conversion - is possible. A natural signature for this function can be: -

      -
      #include <boost/optional.hpp>
-boost::optional<int> convert(const std::string& text);
-
      -

      - All necessary functionality can be included with one header <boost/optional.hpp>. - The above function signature means that the function can either return a - value of type int or a flag - indicating that no value of int - is available. This does not indicate an error. It is like one additional - value of int. This is how we - can use our function: -

      -
      const std::string& text = /*... */;
-boost::optional<int> oi = convert(text); // move-construct
-if (oi)                                 // contextual conversion to bool
-  int i = *oi;                          // operator*
-
      -

      - In order to test if optional - contains a value, we use the contextual conversion to type bool. Because of this we can combine the initialization - of the optional object and the test into one instruction: -

      -
      if (boost::optional<int> oi = convert(text))
-  int i = *oi;
-
      -

      - We extract the contained value with operator* (and with operator-> where it makes sense). An attempt to - extract the contained value of an uninitialized optional object is an undefined - behaviour (UB). This implementation guards the call with BOOST_ASSERT. Therefore you should be sure - that the contained value is there before extracting. For instance, the following - code is reasonably UB-safe: -

      -
      int i = *convert("100");
-
      -

      - This is because we know that string value "100" - converts to a valid value of int. - If you do not like this potential UB, you can use an alternative way of extracting - the contained value: -

      -
      try {
-  int j = convert(text).value();
-}
-catch (const boost::bad_optional_access&) {
-  // deal with it
-}
-
      -

      - This version throws an exception upon an attempt to access a nonexistent - contained value. If your way of dealing with the missing value is to use - some default, like 0, there exists - a yet another alternative: -

      -
      int k = convert(text).value_or(0);
-
      -

      - This uses the atoi-like approach - to conversions: if text does - not represent an integral number just return 0. - Now, let's consider how function convert - can be implemented. -

      -
      boost::optional<int> convert(const std::string& text)
-{
-  std::stringstream s(text);
-  int i;
-  if ((s >> i) && s.get() == std::char_traits<char>::eof())
-    return i;
-  else
-    return boost::none;
-}
-
      -

      - Observe the two return statements. return - i uses the converting constructor - that can create optional<T> - from T. Thus constructed - optional object is initialized and its value is a copy of i. - The other return statement uses another converting constructor from a special - tag boost::none. It is used to indicate that we want - to create an uninitialized optional object. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/quick_start/storage_in_containers.html b/doc/html/boost_optional/quick_start/storage_in_containers.html deleted file mode 100644 index 95809140..00000000 --- a/doc/html/boost_optional/quick_start/storage_in_containers.html +++ /dev/null @@ -1,64 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Suppose you want to ask users to choose some number (an int). - One of the valid responses is to choose nothing, which is represented by - an uninitialized optional<int>. - You want to make a histogram showing how many times each choice was made. - You can use an std::map: -

      -
      std::map<boost::optional<int>, int> choices;
-
-for (int i = 0; i < LIMIT; ++i) {
-  boost::optional<int> choice = readChoice();
-  ++choices[choice];
-}
-
      -

      - This works because optional<T> - is LessThanComparable whenever T is LessThanComparable. In this case - the state of being uninitialized is treated as a yet another value of T, which is compared less than any value - of T. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/rebinding_semantics_for_assignment_of_optional_references.html b/doc/html/boost_optional/rebinding_semantics_for_assignment_of_optional_references.html deleted file mode 100644 index bfcba148..00000000 --- a/doc/html/boost_optional/rebinding_semantics_for_assignment_of_optional_references.html +++ /dev/null @@ -1,148 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - If you assign to an uninitialized optional<T&> - the effect is to bind (for the first time) to the object. Clearly, there is - no other choice. -

      -
      int x = 1 ;
-int& rx = x ;
-optional<int&> ora ;
-optional<int&> orb(x) ;
-ora = orb ; // now 'ora' is bound to 'x' through 'rx'
-*ora = 2 ; // Changes value of 'x' through 'ora'
-assert(x==2);
-
      -

      - If you assign to a bare C++ reference, the assignment is forwarded to the referenced - object; its value changes but the reference is never rebound. -

      -
      int a = 1 ;
-int& ra = a ;
-int b = 2 ;
-int& rb = b ;
-ra = rb ; // Changes the value of 'a' to 'b'
-assert(a==b);
-b = 3 ;
-assert(ra!=b); // 'ra' is not rebound to 'b'
-
      -

      - Now, if you assign to an initialized optional<T&>, - the effect is to rebind to the new object - instead of assigning the referee. This is unlike bare C++ references. -

      -
      int a = 1 ;
-int b = 2 ;
-int& ra = a ;
-int& rb = b ;
-optional<int&> ora(ra) ;
-optional<int&> orb(rb) ;
-ora = orb ; // 'ora' is rebound to 'b'
-*ora = 3 ; // Changes value of 'b' (not 'a')
-assert(a==1);
-assert(b==3);
-
      -

      - - Rationale -

      -

      - Rebinding semantics for the assignment of initialized - optional references has been - chosen to provide consistency among initialization states - even at the expense of lack of consistency with the semantics of bare C++ references. - It is true that optional<U> strives - to behave as much as possible as U - does whenever it is initialized; but in the case when U - is T&, - doing so would result in inconsistent behavior w.r.t to the lvalue initialization - state. -

      -

      - Imagine optional<T&> - forwarding assignment to the referenced object (thus changing the referenced - object value but not rebinding), and consider the following code: -

      -
      optional<int&> a = get();
-int x = 1 ;
-int& rx = x ;
-optional<int&> b(rx);
-a = b ;
-
      -

      - What does the assignment do? -

      -

      - If a is uninitialized, - the answer is clear: it binds to x - (we now have another reference to x). - But what if a is already initialized? - it would change the value of the referenced object (whatever that is); which - is inconsistent with the other possible case. -

      -

      - If optional<T&> - would assign just like T& - does, you would never be able to use Optional's assignment without explicitly - handling the previous initialization state unless your code is capable of functioning - whether after the assignment, a - aliases the same object as b - or not. -

      -

      - That is, you would have to discriminate in order to be consistent. -

      -

      - If in your code rebinding to another object is not an option, then it is very - likely that binding for the first time isn't either. In such case, assignment - to an uninitialized optional<T&> - shall be prohibited. It is quite possible that in such a scenario it is a precondition - that the lvalue must be already initialized. If it isn't, then binding for - the first time is OK while rebinding is not which is IMO very unlikely. In - such a scenario, you can assign the value itself directly, as in: -

      -
      assert(!!opt);
-*opt=value;
-
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/acknowledgements.html b/doc/html/boost_optional/reference/acknowledgements.html deleted file mode 100644 index f5a719de..00000000 --- a/doc/html/boost_optional/reference/acknowledgements.html +++ /dev/null @@ -1,131 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHome -
      -
      -
      -
      - - Pre-formal - review -
      -
        -
      • - Peter Dimov suggested the name 'optional', and was the first to point - out the need for aligned storage. -
        • -
      • - Douglas Gregor developed 'type_with_alignment', and later Eric Friedman - coded 'aligned_storage', which are the core of the optional class implementation. -
        • -
      • - Andrei Alexandrescu and Brian Parker also worked with aligned storage - techniques and their work influenced the current implementation. -
        • -
      • - Gennadiy Rozental made extensive and important comments which shaped - the design. -
        • -
      • - Vesa Karvonen and Douglas Gregor made quite useful comparisons between - optional, variant and any; and made other relevant comments. -
        • -
      • - Douglas Gregor and Peter Dimov commented on comparisons and evaluation - in boolean contexts. -
        • -
      • - Eric Friedman helped understand the issues involved with aligned storage, - move/copy operations and exception safety. -
        • -
      • - Many others have participated with useful comments: Aleksey Gurotov, - Kevlin Henney, David Abrahams, and others I can't recall. -
        • -
      -
      - - Post-formal - review -
      -
        -
      • - William Kempf carefully considered the originally proposed interface - and suggested the new interface which is currently used. He also started - and fueled the discussion about the analogy optional<>/smart pointer - and about relational operators. -
        • -
      • - Peter Dimov, Joel de Guzman, David Abrahams, Tanton Gibbs and Ian Hanson - focused on the relational semantics of optional (originally undefined); - concluding with the fact that the pointer-like interface doesn't make - it a pointer so it shall have deep relational operators. -
        • -
      • - Augustus Saunders also explored the different relational semantics between - optional<> and a pointer and developed the OptionalPointee concept - as an aid against potential conflicts on generic code. -
        • -
      • - Joel de Guzman noticed that optional<> can be seen as an API on - top of variant<T,nil_t>. -
        • -
      • - Dave Gomboc explained the meaning and usage of the Haskell analog to - optional<>: the Maybe type constructor (analogy originally pointed - out by David Sankel). -
        • -
      • - Other comments were posted by Vincent Finn, Anthony Williams, Ed Brey, - Rob Stewart, and others. -
        • -
      • - Joel de Guzman made the case for the support of references and helped - with the proper semantics. -
        • -
      • - Mat Marcus shown the virtues of a value-oriented interface, influencing - the current design, and contributed the idea of "none". -
        • -
      • - Vladimir Batov's design of Boost.Convert library motivated the development - of value accessors for optional: - functions value, value_or, value_or_eval. -
        • -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2016 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHome -
      - - diff --git a/doc/html/boost_optional/reference/dependencies_and_portability.html b/doc/html/boost_optional/reference/dependencies_and_portability.html deleted file mode 100644 index 5128861e..00000000 --- a/doc/html/boost_optional/reference/dependencies_and_portability.html +++ /dev/null @@ -1,84 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      -
      -

      - The implementation uses the following other Boost modules: -

      -
        -
      1. - assert -
        2. -
      2. - config -
        3. -
      3. - core -
        4. -
      4. - detail -
        5. -
      5. - move -
        6. -
      6. - mpl -
        7. -
      7. - static_assert -
        8. -
      8. - throw_exception -
        9. -
      9. - type_traits -
        10. -
      10. - utility -
        11. -
      -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2016 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/dependencies_and_portability/optional_reference_binding.html b/doc/html/boost_optional/reference/dependencies_and_portability/optional_reference_binding.html deleted file mode 100644 index 16c16378..00000000 --- a/doc/html/boost_optional/reference/dependencies_and_portability/optional_reference_binding.html +++ /dev/null @@ -1,100 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - On compilers that do not conform to Standard C++ rules of reference binding, - operations on optional references might give adverse results: rather than - binding a reference to a designated object they may create an unexpected - temporary and bind to it. Compilers known to have these deficiencies include - GCC versions 4.2, 4.3, 4.4, 4.5; QCC 4.4.2; MSVC versions 8.0, 9.0, 10.0, - 11.0, 12.0. On these compilers prefer using direct-initialization and copy - assignment of optional references to copy-initialization and assignment - from T&: -

      -
      const int i = 0;
-optional<const int&> or1;
-optional<const int&> or2 = i;  // not portable
-or1 = i;                       // not portable
-
-optional<const int&> or3(i);   // portable
-or1 = optional<const int&>(i); // portable
-
      -

      - In order to check if your compiler correctly implements reference binding - use this test program. -

      -
      #include <cassert>
-
-const int global_i = 0;
-
-struct TestingReferenceBinding
-{
-  TestingReferenceBinding(const int& ii)
-  {
-    assert(&ii == &global_i);
-  }
-
-  void operator=(const int& ii)
-  {
-    assert(&ii == &global_i);
-  }
-
-  void operator=(int&&) // remove this if your compiler doesn't have rvalue refs
-  {
-    assert(false);
-  }
-};
-
-int main()
-{
-  const int& iref = global_i;
-  assert(&iref == &global_i);
-
-  TestingReferenceBinding ttt = global_i;
-  ttt = global_i;
-
-  TestingReferenceBinding ttt2 = iref;
-  ttt2 = iref;
-}
-
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2016 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html deleted file mode 100644 index f5b40337..00000000 --- a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_.html +++ /dev/null @@ -1,63 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      -
      -

      -

      -
      namespace boost {
-
-class bad_optional_access : public std::logic_error
-{
-public:
-    bad_optional_access(); R
-};
-
-} // namespace boost
-
      -

      -

      -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html b/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html deleted file mode 100644 index eea25e98..00000000 --- a/doc/html/boost_optional/reference/header__boost_optional_bad_optional_access_hpp_/detailed_semantics.html +++ /dev/null @@ -1,60 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - space -

      -

      - bad_optional_access(); -

      -
        -
      • - Effect: Constructs an object of class - bad_optional_access. -
        • -
      • - Postconditions: what() returns an implementation-defined - NTBS. -
        • -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/header__boost_optional_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_hpp_.html deleted file mode 100644 index 8390a062..00000000 --- a/doc/html/boost_optional/reference/header__boost_optional_hpp_.html +++ /dev/null @@ -1,47 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - This is an alias for header <boost/optional/optional.hpp>. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html deleted file mode 100644 index 45d55b27..00000000 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_fwd_hpp_.html +++ /dev/null @@ -1,66 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      -
      -

      -

      -
      namespace boost {
-
-template <class T> class optional ;
-
-template <class T> void swap ( optional<T>& , optional<T>& );
-
-template <class T> struct optional_swap_should_use_default_constructor ;
-
-} // namespace boost
-
      -

      -

      -

      - This header only contains declarations. -

      -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html deleted file mode 100644 index 2b6f9eb4..00000000 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics.html +++ /dev/null @@ -1,2423 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Because T might be of reference - type, in the sequel, those entries whose semantic depends on T being of reference type or not will - be distinguished using the following convention: -

      -
        -
      • - If the entry reads: optional<T(not - a ref)>, - the description corresponds only to the case where T - is not of reference type. -
        • -
      • - If the entry reads: optional<T&>, the description corresponds - only to the case where T - is of reference type. -
        • -
      • - If the entry reads: optional<T>, the description is the same for - both cases. -
        • -
      -
      - - - - - -
      [Note]Note

      - The following section contains various assert() which are used only to show the postconditions - as sample code. It is not implied that the type T - must support each particular expression but that if the expression is - supported, the implied condition holds. -

      -

      - space -

      -
      - - optional - class member functions -
      -

      - space -

      -

      - optional<T>::optional() - noexcept; -

      -
        -
      • - Effect: Default-Constructs an optional. -
        • -
      • - Postconditions: *this is uninitialized. -
        • -
      • - Notes: T's default constructor is not called. -
        • -
      • - Example: -
        optional<T> def ;
-assert ( !def ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T>::optional( - none_t ) - noexcept; -

      -
        -
      • - Effect: Constructs an optional uninitialized. -
        • -
      • - Postconditions: *this is uninitialized. -
        • -
      • - Notes: T's - default constructor is not called. - The expression boost::none - denotes an instance of boost::none_t - that can be used as the parameter. -
        • -
      • - Example: -
        #include <boost/none.hpp>
-optional<T> n(none) ;
-assert ( !n ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T (not a ref)>::optional( T const& v ) -

      -
        -
      • - Requires: is_copy_constructible<T>::value - is true. -
        • -
      • - Effect: Directly-Constructs an optional. -
        • -
      • - Postconditions: *this is initialized - and its value is a copy of v. -
        • -
      • - Throws: Whatever T::T( T const& - ) throws. -
        • -
      • - Notes: T::T( T const& - ) is called. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T const& - ); in that case, this constructor - has no effect. -
        • -
      • - Example: -
        T v;
-optional<T> opt(v);
-assert ( *opt == v ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>::optional( - T& - ref ) -

      -
        -
      • - Effect: Directly-Constructs an optional. -
        • -
      • - Postconditions: *this is initialized - and its value is an instance of an internal type wrapping the reference - ref. -
        • -
      • - Throws: Nothing. -
        • -
      • - Example: -
        T v;
-T& vref = v ;
-optional<T&> opt(vref);
-assert ( *opt == v ) ;
-++ v ; // mutate referee
-assert (*opt == v);
-
        -
        • -
      -

      - space -

      -

      - optional<T (not a ref)>::optional( T&& v - ) -

      -
        -
      • - Requires: is_move_constructible<T>::value - is true. -
        • -
      • - Effect: Directly-Move-Constructs an - optional. -
        • -
      • - Postconditions: *this is initialized - and its value is move-constructed from v. -
        • -
      • - Throws: Whatever T::T( T&& ) - throws. -
        • -
      • - Notes: T::T( T&& ) - is called. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T&& ); - in that case, the state of v - is determined by exception safety guarantees for T::T(T&&). -
        • -
      • - Example: -
        T v1, v2;
-optional<T> opt(std::move(v1));
-assert ( *opt == v2 ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>::optional( - T&& - ref ) - = delete -

      -
      • - Notes: This constructor is deleted -
      -

      - space -

      -

      - optional<T (not a ref)>::optional( bool condition, - T const& v ) ; -

      -

      - optional<T&> - ::optional( bool condition, - T& - v ) - ; -

      -
      • - If condition is true, same as: -
      -

      - optional<T (not a ref)>::optional( T const& v ) -

      -

      - optional<T&> - ::optional( T& v ) -

      -
      • - otherwise, same as: -
      -

      - optional<T (not a ref)>::optional() -

      -

      - optional<T&> - ::optional() -

      -

      - space -

      -

      - optional<T (not a ref)>::optional( optional - const& - rhs ); -

      -
        -
      • - Requires: is_copy_constructible<T>::value - is true. -
        • -
      • - Effect: Copy-Constructs an optional. -
        • -
      • - Postconditions: If rhs is initialized, - *this - is initialized and its value is a copy of the - value of rhs; else - *this - is uninitialized. -
        • -
      • - Throws: Whatever T::T( T const& - ) throws. -
        • -
      • - Notes: If rhs is initialized, T::T(T const& ) - is called. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T const& - ); in that case, this constructor - has no effect. -
        • -
      • - Example: -
        optional<T> uninit ;
-assert (!uninit);
-
-optional<T> uinit2 ( uninit ) ;
-assert ( uninit2 == uninit );
-
-optional<T> init( T(2) );
-assert ( *init == T(2) ) ;
-
-optional<T> init2 ( init ) ;
-assert ( init2 == init ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>::optional( - optional const& rhs - ); -

      -
        -
      • - Effect: Copy-Constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is another reference to the same object - referenced by *rhs; - else *this - is uninitialized. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: If rhs - is initialized, both *this and *rhs will refer to the same object - (they alias). -
        • -
      • - Example: -
        optional<T&> uninit ;
-assert (!uninit);
-
-optional<T&> uinit2 ( uninit ) ;
-assert ( uninit2 == uninit );
-
-T v = 2 ; T& ref = v ;
-optional<T> init(ref);
-assert ( *init == v ) ;
-
-optional<T> init2 ( init ) ;
-assert ( *init2 == v ) ;
-
-v = 3 ;
-
-assert ( *init  == 3 ) ;
-assert ( *init2 == 3 ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T (not a ref)>::optional( optional&& rhs - ) noexcept(see below); -

      -
        -
      • - Requires: is_move_constructible<T>::value - is true. -
        • -
      • - Effect: Move-constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is move constructed from rhs; else *this is uninitialized. -
        • -
      • - Throws: Whatever T::T( T&& ) - throws. -
        • -
      • - Remarks: The expression inside noexcept is equivalent to is_nothrow_move_constructible<T>::value. -
        • -
      • - Notes: If rhs - is initialized, T::T( T && - ) is called. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T&& ); - in that case, rhs remains - initialized and the value of *rhs is determined by exception safety - of T::T(T&&). -
        • -
      • - Example: -
        optional<std::unique_ptr<T>> uninit ;
-assert (!uninit);
-
-optional<std::unique_ptr<T>> uinit2 ( std::move(uninit) ) ;
-assert ( uninit2 == uninit );
-
-optional<std::unique_ptr<T>> init( std::unique_ptr<T>(new T(2)) );
-assert ( **init == T(2) ) ;
-
-optional<std::unique_ptr<T>> init2 ( std::move(init) ) ;
-assert ( init );
-assert ( *init == nullptr );
-assert ( init2 );
-assert ( **init2 == T(2) ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>::optional( - optional && - rhs ); -

      -
        -
      • - Effect: Move-Constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is another reference to the same object - referenced by *rhs; - else *this - is uninitialized. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: If rhs - is initialized, both *this and *rhs will refer to the same object - (they alias). -
        • -
      • - Example: -
        optional<std::unique_ptr<T>&> uninit ;
-assert (!uninit);
-
-optional<std::unique_ptr<T>&> uinit2 ( std::move(uninit) ) ;
-assert ( uninit2 == uninit );
-
-std::unique_ptr<T> v(new T(2)) ;
-optional<std::unique_ptr<T>&> init(v);
-assert ( *init == v ) ;
-
-optional<std::unique_ptr<T>&> init2 ( std::move(init) ) ;
-assert ( *init2 == v ) ;
-
-*v = 3 ;
-
-assert ( **init  == 3 ) ;
-assert ( **init2 == 3 ) ;
-
        -
        • -
      -

      - space -

      -

      - template<U> explicit optional<T - (not a ref)>::optional( - optional<U> const& rhs ); -

      -
        -
      • - Effect: Copy-Constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is a copy of the - value of rhs converted to type T; - else *this - is uninitialized. -
        • -
      • - Throws: Whatever T::T( U const& - ) throws. -
        • -
      • - Notes: T::T( U const& - ) is called if rhs is initialized, which requires - a valid conversion from U - to T. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( U const& - ); in that case, this constructor - has no effect. -
        • -
      • - Example: -
        optional<double> x(123.4);
-assert ( *x == 123.4 ) ;
-
-optional<int> y(x) ;
-assert( *y == 123 ) ;
-
        -
        • -
      -

      - space -

      -

      - template<U> explicit optional<T - (not a ref)>::optional( - optional<U>&& - rhs ); -

      -
        -
      • - Effect: Move-constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is move-constructed from *rhs; - else *this - is uninitialized. -
        • -
      • - Throws: Whatever T::T( U&& ) - throws. -
        • -
      • - Notes: T::T( U&& ) - is called if rhs is - initialized, which requires a valid conversion from U - to T. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( U&& ); - in that case, rhs remains - initialized and the value of *rhs is determined by exception safety - guarantee of T::T( U&& - ). -
        • -
      • - Example: -
        optional<double> x(123.4);
-assert ( *x == 123.4 ) ;
-
-optional<int> y(std::move(x)) ;
-assert( *y == 123 ) ;
-
        -
        • -
      -

      - space -

      -

      - template<InPlaceFactory> - explicit optional<T - (not a ref)>::optional( - InPlaceFactory const& f ); -

      -

      - template<TypedInPlaceFactory> - explicit optional<T - (not a ref)>::optional( - TypedInPlaceFactory const& f ); -

      -
        -
      • - Effect: Constructs an optional with a value of T obtained from the factory. -
        • -
      • - Postconditions: *this is initialized - and its value is directly given from the factory - f (i.e., the value - is not copied). -
        • -
      • - Throws: Whatever the T constructor called by the factory - throws. -
        • -
      • - Notes: See In-Place - Factories -
        • -
      • - Exception Safety: Exceptions can only - be thrown during the call to the T - constructor used by the factory; in that case, this constructor has - no effect. -
        • -
      • - Example: -
        class C { C ( char, double, std::string ) ; } ;
-
-C v('A',123.4,"hello");
-
-optional<C> x( in_place   ('A', 123.4, "hello") ); // InPlaceFactory used
-optional<C> y( in_place<C>('A', 123.4, "hello") ); // TypedInPlaceFactory used
-
-assert ( *x == v ) ;
-assert ( *y == v ) ;
-
        -
        • -
      -

      - space -

      -

      - optional& - optional<T>::operator= ( none_t - ) noexcept; -

      -
        -
      • - Effect: If *this is initialized destroys its contained - value. -
        • -
      • - Postconditions: *this is uninitialized. -
        • -
      -

      - space -

      -

      - optional& - optional<T (not a ref)>::operator= ( T - const& - rhs ) - ; -

      -
        -
      • - Effect: Assigns the value rhs to an optional. -
        • -
      • - Postconditions: *this is initialized and its value is - a copy of rhs. -
        • -
      • - Throws: Whatever T::operator=( T const& - ) or T::T(T const&) - throws. -
        • -
      • - Notes: If *this was initialized, T's assignment operator is used, - otherwise, its copy-constructor is used. -
        • -
      • - Exception Safety: In the event of - an exception, the initialization state of *this is unchanged and its value unspecified - as far as optional - is concerned (it is up to T's - operator=()). - If *this - is initially uninitialized and T's - copy constructor fails, *this is left properly uninitialized. -
        • -
      • - Example: -
        T x;
-optional<T> def ;
-optional<T> opt(x) ;
-
-T y;
-def = y ;
-assert ( *def == y ) ;
-opt = y ;
-assert ( *opt == y ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>& - optional<T&>::operator= ( T& rhs - ) ; -

      -
        -
      • - Effect: (Re)binds the wrapped reference. -
        • -
      • - Postconditions: *this is initialized and it references - the same object referenced by rhs. -
        • -
      • - Notes: If *this was initialized, it is rebound - to the new object. See here - for details on this behavior. -
        • -
      • - Example: -
        int a = 1 ;
-int b = 2 ;
-T& ra = a ;
-T& rb = b ;
-optional<int&> def ;
-optional<int&> opt(ra) ;
-
-def = rb ; // binds 'def' to 'b' through 'rb'
-assert ( *def == b ) ;
-*def = a ; // changes the value of 'b' to a copy of the value of 'a'
-assert ( b == a ) ;
-int c = 3;
-int& rc = c ;
-opt = rc ; // REBINDS to 'c' through 'rc'
-c = 4 ;
-assert ( *opt == 4 ) ;
-
        -
        • -
      -

      - space -

      -

      - optional& - optional<T (not a ref)>::operator= ( T&& rhs - ) ; -

      -
        -
      • - Effect: Moves the value rhs to an optional. -
        • -
      • - Postconditions: *this is initialized and its value is - moved from rhs. -
        • -
      • - Throws: Whatever T::operator=( T&& ) - or T::T(T &&) - throws. -
        • -
      • - Notes: If *this was initialized, T's move-assignment operator is used, - otherwise, its move-constructor is used. -
        • -
      • - Exception Safety: In the event of - an exception, the initialization state of *this is unchanged and its value unspecified - as far as optional - is concerned (it is up to T's - operator=()). - If *this - is initially uninitialized and T's - move constructor fails, *this is left properly uninitialized. -
        • -
      • - Example: -
        T x;
-optional<T> def ;
-optional<T> opt(x) ;
-
-T y1, y2, yR;
-def = std::move(y1) ;
-assert ( *def == yR ) ;
-opt = std::move(y2) ;
-assert ( *opt == yR ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>& - optional<T&>::operator= ( T&& rhs - ) = - delete; -

      -
      • - Notes: This assignment operator is - deleted. -
      -

      - space -

      -

      - optional& - optional<T (not a ref)>::operator= ( optional - const& - rhs ) - ; -

      -
        -
      • - Requires: T - is CopyConstructible and CopyAssignable. -
        • -
      • -

        - Effects: -

        -
        ----- - - - - - - - - - - - - - - - - - - -
        - -

        - *this contains a value -

        -         		-

        - *this does not contain a value -

        -
        -

        - rhs - contains a value -

        -         		-

        - assigns *rhs - to the contained value -

        -         		-

        - initializes the contained value as if direct-initializing - an object of type T - with *rhs -

        -
        -

        - rhs - does not contain a value -

        -         		-

        - destroys the contained value by calling val->T::~T() -

        -         		-

        - no effect -

        -
        -
        • -
      • - Returns: *this; -
        • -
      • - Postconditions: bool(rhs) == bool(*this). -
        • -
      • - Exception Safety: If any exception - is thrown, the initialization state of *this and rhs - remains unchanged. If an exception is thrown during the call to T's copy constructor, no effect. - If an exception is thrown during the call to T's - copy assignment, the state of its contained value is as defined by - the exception safety guarantee of T's - copy assignment. -
        • -
      • - Example: -
        T v;
-optional<T> opt(v);
-optional<T> def ;
-
-opt = def ;
-assert ( !def ) ;
-// previous value (copy of 'v') destroyed from within 'opt'.
-
        -
        • -
      -

      - space -

      -

      - optional<T&> - & optional<T&>::operator= ( optional<T&> const& rhs - ) ; -

      -
        -
      • - Effect: (Re)binds thee wrapped reference. -
        • -
      • - Postconditions: If *rhs is initialized, *this - is initialized and it references the same object referenced by *rhs; - otherwise, *this - is uninitialized (and references no object). -
        • -
      • - Notes: If *this was initialized and so is *rhs, - *this - is rebound to the new object. See here - for details on this behavior. -
        • -
      • - Example: -
        int a = 1 ;
-int b = 2 ;
-T& ra = a ;
-T& rb = b ;
-optional<int&> def ;
-optional<int&> ora(ra) ;
-optional<int&> orb(rb) ;
-
-def = orb ; // binds 'def' to 'b' through 'rb' wrapped within 'orb'
-assert ( *def == b ) ;
-*def = ora ; // changes the value of 'b' to a copy of the value of 'a'
-assert ( b == a ) ;
-int c = 3;
-int& rc = c ;
-optional<int&> orc(rc) ;
-ora = orc ; // REBINDS ora to 'c' through 'rc'
-c = 4 ;
-assert ( *ora == 4 ) ;
-
        -
        • -
      -

      - space -

      -

      - optional& - optional<T (not a ref)>::operator= ( optional&& rhs - ) noexcept(see below); -

      -
        -
      • - Requires: T - is MoveConstructible - and MoveAssignable. -
        • -
      • -

        - Effects: -

        -
        ----- - - - - - - - - - - - - - - - - - - -
        - -

        - *this contains a value -

        -         		-

        - *this does not contain a value -

        -
        -

        - rhs - contains a value -

        -         		-

        - assigns std::move(*rhs) to the contained value -

        -         		-

        - initializes the contained value as if direct-initializing - an object of type T - with std::move(*rhs) -

        -
        -

        - rhs - does not contain a value -

        -         		-

        - destroys the contained value by calling val->T::~T() -

        -         		-

        - no effect -

        -
        -
        • -
      • - Returns: *this; -
        • -
      • - Postconditions: bool(rhs) == bool(*this). -
        • -
      • - Remarks: The expression inside noexcept is equivalent to is_nothrow_move_constructible<T>::value && - is_nothrow_move_assignable<T>::value. -
        • -
      • - Exception Safety: If any exception - is thrown, the initialization state of *this and rhs - remains unchanged. If an exception is thrown during the call to T's move constructor, the state of - *rhs - is determined by the exception safety guarantee of T's - move constructor. If an exception is thrown during the call to T's - move-assignment, the state of **this and *rhs is determined by the exception - safety guarantee of T's move assignment. -
        • -
      • - Example: -
        optional<T> opt(T(2)) ;
-optional<T> def ;
-
-opt = def ;
-assert ( def ) ;
-assert ( opt ) ;
-assert ( *opt == T(2) ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&> - & optional<T&>::operator= ( optional<T&>&& rhs - ) ; -

      -
      • - Effect: Same as optional<T&>::operator= ( optional<T&> - const& - rhs ). -
      -

      - space -

      -

      - template<U> optional& - optional<T (not a ref)>::operator= ( optional<U> const& rhs - ) ; -

      -
        -
      • -

        - Effect: -

        -
        ----- - - - - - - - - - - - - - - - - - - -
        - -

        - *this contains a value -

        -         		-

        - *this does not contain a value -

        -
        -

        - rhs - contains a value -

        -         		-

        - assigns *rhs - to the contained value -

        -         		-

        - initializes the contained value as if direct-initializing - an object of type T - with *rhs -

        -
        -

        - rhs - does not contain a value -

        -         		-

        - destroys the contained value by calling val->T::~T() -

        -         		-

        - no effect -

        -
        -
        • -
      • - Returns: *this. -
        • -
      • - Postconditions: bool(rhs) == bool(*this). -
        • -
      • - Exception Safety: If any exception - is thrown, the result of the expression bool(*this) remains unchanged. If an exception - is thrown during the call to T's - constructor, no effect. If an exception is thrown during the call to - T's assignment, the - state of its contained value is as defined by the exception safety - guarantee of T's copy - assignment. -
        • -
      • - Example: -
        T v;
-optional<T> opt0(v);
-optional<U> opt1;
-
-opt1 = opt0 ;
-assert ( *opt1 == static_cast<U>(v) ) ;
-
        -
        • -
      -

      - space -

      -

      - template<U> optional& - optional<T (not a ref)>::operator= ( optional<U>&& rhs - ) ; -

      -
        -
      • -

        - Effect: -

        -
        ----- - - - - - - - - - - - - - - - - - - -
        - -

        - *this contains a value -

        -         		-

        - *this does not contain a value -

        -
        -

        - rhs - contains a value -

        -         		-

        - assigns std::move(*rhs) to the contained value -

        -         		-

        - initializes the contained value as if direct-initializing - an object of type T - with std::move(*rhs) -

        -
        -

        - rhs - does not contain a value -

        -         		-

        - destroys the contained value by calling val->T::~T() -

        -         		-

        - no effect -

        -
        -
        • -
      • - Returns: *this. -
        • -
      • - Postconditions: bool(rhs) == bool(*this). -
        • -
      • - Exception Safety: If any exception - is thrown, the result of the expression bool(*this) remains unchanged. If an exception - is thrown during the call to T's - constructor, no effect. If an exception is thrown during the call to - T's assignment, the - state of its contained value is as defined by the exception safety - guarantee of T's copy - assignment. -
        • -
      • - Example: -
        T v;
-optional<T> opt0(v);
-optional<U> opt1;
-
-opt1 = std::move(opt0) ;
-assert ( opt0 );
-assert ( opt1 )
-assert ( *opt1 == static_cast<U>(v) ) ;
-
        -
        • -
      -

      - space -

      -

      - template<class... Args> - void optional<T - (not a ref)>::emplace( - Args...&& - args ); -

      -
        -
      • - Requires: The compiler supports rvalue - references and variadic templates. -
        • -
      • - Effect: If *this is initialized calls *this = none. - Then initializes in-place the contained value as if direct-initializing - an object of type T - with std::forward<Args>(args).... -
        • -
      • - Postconditions: *this is initialized. -
        • -
      • - Throws: Whatever the selected T's constructor throws. -
        • -
      • - Exception Safety: If an exception - is thrown during the initialization of T, - *this - is uninitialized. -
        • -
      • - Notes: T - need not be MoveConstructible - or MoveAssignable. - On compilers that do not support variadic templates, the signature - falls back to two overloads:template<class - Arg> - void emplace(Arg&& arg) and void - emplace(). - On compilers that do not support rvalue references, the signature falls - back to three overloads: taking const - and non-const lvalue reference, - and third with empty function argument list. -
        • -
      • - Example: -
        T v;
-optional<const T> opt;
-opt.emplace(0);  // create in-place using ctor T(int)
-opt.emplace();   // destroy previous and default-construct another T
-opt.emplace(v);  // destroy and copy-construct in-place (no assignment called)
-
        -
        • -
      -

      - space -

      -

      - template<InPlaceFactory> - optional<T>& - optional<T (not a ref)>::operator=( InPlaceFactory - const& - f ); -

      -

      - template<TypedInPlaceFactory> - optional<T>& - optional<T (not a ref)>::operator=( TypedInPlaceFactory - const& - f ); -

      -
        -
      • - Effect: Assigns an optional - with a value of T obtained - from the factory. -
        • -
      • - Postconditions: *this is initialized - and its value is directly given from the factory - f (i.e., the value - is not copied). -
        • -
      • - Throws: Whatever the T constructor called by the factory - throws. -
        • -
      • - Notes: See In-Place - Factories -
        • -
      • - Exception Safety: Exceptions can only - be thrown during the call to the T - constructor used by the factory; in that case, the optional - object will be reset to be uninitialized. -
        • -
      -

      - space -

      -

      - void optional<T - (not a ref)>::reset( T const& v ) ; -

      -
      • - Deprecated: same as operator= - ( T - const& - v) - ; -
      -

      - space -

      -

      - void optional<T>::reset() noexcept - ; -

      -
      • - Deprecated: Same as operator=( - none_t ); -
      -

      - space -

      -

      - T const& optional<T - (not a ref)>::get() const ; -

      -

      - T& - optional<T (not a ref)>::get() ; -

      -

      - inline T - const& - get ( - optional<T (not a ref)> const& ) ; -

      -

      - inline T& get - ( optional<T - (not a ref)> - &) ; -

      -
        -
      • - Requires: *this is initialized -
        • -
      • - Returns: A reference to the contained - value -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). -
        • -
      -

      - space -

      -

      - T const& optional<T&>::get() const ; -

      -

      - T& - optional<T&>::get() ; -

      -

      - inline T - const& - get ( - optional<T&> - const& - ) ; -

      -

      - inline T& get - ( optional<T&> &) - ; -

      -
        -
      • - Requires: *this is initialized -
        • -
      • - Returns: The - reference contained. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). -
        • -
      -

      - space -

      -

      - T const& optional<T - (not a ref)>::operator*() - const& - ; -

      -

      - T& - optional<T (not a ref)>::operator*() &; -

      -
        -
      • - Requires: *this is initialized -
        • -
      • - Returns: A reference to the contained - value -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). - On compilers that do not support ref-qualifiers on member functions - these two overloads are replaced with the classical two: a const and non-const - member functions. -
        • -
      • - Example: -
        T v ;
-optional<T> opt ( v );
-T const& u = *opt;
-assert ( u == v ) ;
-T w ;
-*opt = w ;
-assert ( *opt == w ) ;
-
        -
        • -
      -

      - space -

      -

      - T&& - optional<T (not a ref)>::operator*() &&; -

      -
        -
      • - Requires: *this contains a value. -
        • -
      • - Effects: Equivalent to return std::move(*val);. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). - On compilers that do not support ref-qualifiers on member functions - this overload is not present. -
        • -
      -

      - space -

      -

      - T & - optional<T&>::operator*() - const& - ; -

      -

      - T & - optional<T&>::operator*() - & ; -

      -

      - T & - optional<T&>::operator*() - && ; -

      -
        -
      • - Requires: *this is initialized -
        • -
      • - Returns: The - reference contained. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). - On compilers that do not support ref-qualifiers on member functions - these three overloads are replaced with the classical two: a const and non-const - member functions. -
        • -
      • - Example: -
        T v ;
-T& vref = v ;
-optional<T&> opt ( vref );
-T const& vref2 = *opt;
-assert ( vref2 == v ) ;
-++ v ;
-assert ( *opt == v ) ;
-
        -
        • -
      -

      - space -

      -

      - T const& optional<T>::value() const& ; -

      -

      - T& - optional<T>::value() & ; -

      -
        -
      • - Effects: Equivalent to return bool(*this) ? *val : throw bad_optional_access();. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions these two overloads are replaced - with the classical two: a const - and non-const member functions. -
        • -
      • - Example: -
        T v ;
-optional<T> o0, o1 ( v );
-assert ( o1.value() == v );
-
-try {
-  o0.value(); // throws
-  assert ( false );
-}
-catch(bad_optional_access&) {
-  assert ( true );
-}
-
        -
        • -
      -

      - space -

      -

      - T&& - optional<T>::value() && ; -

      -
        -
      • - Effects: Equivalent to return bool(*this) ? std::move(*val) : throw bad_optional_access();. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions this overload is not present. -
        • -
      -

      - space -

      -

      - template<class U> T optional<T>::value_or(U && - v) - const& - ; -

      -
        -
      • - Effects: Equivalent to if (*this) return **this; else return - std::forward<U>(v);. -
        • -
      • - Remarks: If T - is not CopyConstructible or U && - is not convertible to T, - the program is ill-formed. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions this overload is replaced with the - const-qualified member - function. On compilers without rvalue reference support the type of - v becomes U const&. -
        • -
      -

      - space -

      -

      - template<class U> T optional<T>::value_or(U && - v) - && ; -

      -
        -
      • - Effects: Equivalent to if (*this) return std::move(**this); else return std::forward<U>(v);. -
        • -
      • - Remarks: If T - is not MoveConstructible - or U && - is not convertible to T, - the program is ill-formed. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions this overload is not present. -
        • -
      -

      - space -

      -

      - template<class F> T optional<T>::value_or_eval(F f) const& ; -

      -
        -
      • - Requires: T - is CopyConstructible and F models a Generator whose result type - is convertible to T. -
        • -
      • - Effects: if - (*this) return **this; else return f();. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions this overload is replaced with the - const-qualified member - function. -
        • -
      • - Example: -
        int complain_and_0()
-{
-  clog << "no value returned, using default" << endl;
-  return 0;
-}
-
-optional<int> o1 = 1;
-optional<int> oN = none;
-
-int i = o1.value_or_eval(complain_and_0); // fun not called
-assert (i == 1);
-
-int j = oN.value_or_eval(complain_and_0); // fun called
-assert (i == 0);
-
        -
        • -
      -

      - space -

      -

      - template<class F> T optional<T>::value_or_eval(F f) && - ; -

      -
        -
      • - Requires: T - is MoveConstructible - and F models a Generator - whose result type is convertible to T. -
        • -
      • - Effects: if - (*this) return std::move(**this); else return - f();. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions this overload is not present. -
        • -
      -

      - space -

      -

      - T const& optional<T - (not a ref)>::get_value_or( - T const& default) const ; -

      -

      - T& - optional<T (not a ref)>::get_value_or( T& default - ) ; -

      -

      - inline T - const& - get_optional_value_or ( - optional<T (not a ref)> const& o, T const& default ) ; -

      -

      - inline T& get_optional_value_or - ( optional<T - (not a ref)>& - o, - T& - default ) - ; -

      -
        -
      • - Deprecated: Use value_or() instead. -
        • -
      • - Returns: A reference to the contained - value, if any, or default. -
        • -
      • - Throws: Nothing. -
        • -
      • - Example: -
        T v, z ;
-optional<T> def;
-T const& y = def.get_value_or(z);
-assert ( y == z ) ;
-
-optional<T> opt ( v );
-T const& u = get_optional_value_or(opt,z);
-assert ( u == v ) ;
-assert ( u != z ) ;
-
        -
        • -
      -

      - space -

      -

      - T const* optional<T - (not a ref)>::get_ptr() - const ; -

      -

      - T* - optional<T (not a ref)>::get_ptr() ; -

      -

      - inline T - const* - get_pointer ( - optional<T (not a ref)> const& ) ; -

      -

      - inline T* get_pointer - ( optional<T - (not a ref)> - &) ; -

      -
        -
      • - Returns: If *this is initialized, a pointer to the - contained value; else 0 - (null). -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The contained value is permanently - stored within *this, - so you should not hold nor delete this pointer -
        • -
      • - Example: -
        T v;
-optional<T> opt(v);
-optional<T> const copt(v);
-T* p = opt.get_ptr() ;
-T const* cp = copt.get_ptr();
-assert ( p == get_pointer(opt) );
-assert ( cp == get_pointer(copt) ) ;
-
        -
        • -
      -

      - space -

      -

      - T const* optional<T - (not a ref)>::operator ->() - const ; -

      -

      - T* - optional<T (not a ref)>::operator - ->() ; -

      -
        -
      • - Requires: *this is initialized. -
        • -
      • - Returns: A pointer to the contained - value. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). -
        • -
      • - Example: -
        struct X { int mdata ; } ;
-X x ;
-optional<X> opt (x);
-opt->mdata = 2 ;
-
        -
        • -
      -

      - space -

      -

      - explicit optional<T>::operator - bool() - const noexcept - ; -

      -
        -
      • - Returns: get_ptr() != 0. -
        • -
      • - Notes: On compilers that do not support - explicit conversion operators this falls back to safe-bool idiom. -
        • -
      • - Example: -
        optional<T> def ;
-assert ( def == 0 );
-optional<T> opt ( v ) ;
-assert ( opt );
-assert ( opt != 0 );
-
        -
        • -
      -

      - space -

      -

      - bool optional<T>::operator!() noexcept - ; -

      -
        -
      • - Returns: If *this is uninitialized, true; else false. -
        • -
      • - Notes: This operator is provided for - those compilers which can't use the unspecified-bool-type - operator in certain boolean contexts. -
        • -
      • - Example: -
        optional<T> opt ;
-assert ( !opt );
-*opt = some_T ;
-
-// Notice the "double-bang" idiom here.
-assert ( !!opt ) ;
-
        -
        • -
      -

      - space -

      -

      - bool optional<T>::is_initialized() const ; -

      -
      • - Deprecated: Same as explicit operator - bool () - ; -
      -

      - space -

      -
      - - Free - functions -
      -

      - space -

      -

      - optional<T (not a ref)> make_optional( T const& v ) -

      -
        -
      • - Returns: optional<T>(v) for the deduced - type T of v. -
        • -
      • - Example: -
        template<class T> void foo ( optional<T> const& opt ) ;
-
-foo ( make_optional(1+1) ) ; // Creates an optional<int>
-
        -
        • -
      -

      - space -

      -

      - optional<T (not a ref)> make_optional( bool condition, - T const& v ) -

      -
        -
      • - Returns: optional<T>(condition,v) for the deduced - type T of v. -
        • -
      • - Example: -
        optional<double> calculate_foo()
-{
-  double val = compute_foo();
-  return make_optional(is_not_nan_and_finite(val),val);
-}
-
-optional<double> v = calculate_foo();
-if ( !v )
-  error("foo wasn't computed");
-
        -
        • -
      -

      - space -

      -

      - bool operator - == ( - optional<T> const& x, optional<T> const& y ); -

      -
        -
      • - Requires: T - shall meet requirements of EqualityComparable. -
        • -
      • - Returns: If both x - and y are initialized, - (*x - == *y). - If only x or y is initialized, false. - If both are uninitialized, true. -
        • -
      • - Notes: This definition guarantees - that optional<T> - not containing a value is compared unequal to any optional<T> containing any value, and equal - to any other optional<T> not containing a value. Pointers - have shallow relational operators while optional - has deep relational operators. Do not use operator== directly in generic code which expect - to be given either an optional<T> or a pointer; use equal_pointees() - instead -
        • -
      • - Example: -
        optional<T> oN, oN_;
-optional<T> o1(T(1)), o1_(T(1));
-optional<T> o2(T(2));
-
-assert ( oN == oN );  // Identity implies equality
-assert ( o1 == o1 );  //
-
-assert ( oN == oN_ ); // Both uninitialized compare equal
-
-assert ( oN != o1 );  // Initialized unequal to initialized.
-
-assert ( o1 == o1_ ); // Both initialized compare as (*lhs == *rhs)
-assert ( o1 != o2 );  //
-
        -
        • -
      -

      - space -

      -

      - bool operator - < ( - optional<T> const& x, optional<T> const& y ); -

      -
        -
      • - Requires: Expression *x < *y shall be well-formed and its result - shall be convertible to bool. -
        • -
      • - Returns: (!y) ? false : (!x) ? true : *x < - *y. -
        • -
      • - Notes: This definition guarantees - that optional<T> - not containing a value is ordered as less than any optional<T> containing any value, and equivalent - to any other optional<T> not containing a value. Pointers - have shallow relational operators while optional - has deep relational operators. Do not use operator< directly in generic code which - expect to be given either an optional<T> or a pointer; use less_pointees() - instead. T need not - be LessThanComparable. Only - single operator< - is required. Other relational operations are defined in terms of this - one. If T's operator< - satisfies the axioms of LessThanComparable (transitivity, - antisymmetry and irreflexivity), optional<T> is LessThanComparable. -
        • -
      • - Example: -
        optional<T> oN, oN_;
-optional<T> o0(T(0));
-optional<T> o1(T(1));
-
-assert ( !(oN < oN) );  // Identity implies equivalence
-assert ( !(o1 < o1) );
-
-assert ( !(oN < oN_) ); // Two uninitialized are equivalent
-assert ( !(oN_ < oN) );
-
-assert ( oN < o0 );     // Uninitialized is less than initialized
-assert ( !(o0 < oN) );
-
-assert ( o1 < o2 ) ;    // Two initialized compare as (*lhs < *rhs)
-assert ( !(o2 < o1) ) ;
-assert ( !(o2 < o2) ) ;
-
        -
        • -
      -

      - space -

      -

      - bool operator - != ( - optional<T> const& x, optional<T> const& y ); -

      -
      • - Returns: !( - x == - y ); -
      -

      - space -

      -

      - bool operator - > ( - optional<T> const& x, optional<T> const& y ); -

      -
      • - Returns: ( - y < - x ); -
      -

      - space -

      -

      - bool operator - <= ( - optional<T> const& x, optional<T> const& y ); -

      -
      • - Returns: !( - y < - x ); -
      -

      - space -

      -

      - bool operator - >= ( - optional<T> const& x, optional<T> const& y ); -

      -
      • - Returns: !( - x < - y ); -
      -

      - space -

      -

      - bool operator - == ( - optional<T> const& x, none_t ) - noexcept; -

      -

      - bool operator - == ( - none_t, - optional<T> const& x ) noexcept; -

      -
      -

      - space -

      -

      - bool operator - != ( - optional<T> const& x, none_t ) - noexcept; -

      -

      - bool operator - != ( - none_t, - optional<T> const& x ) noexcept; -

      -
      • - Returns: !( - x == - y ); -
      -

      - space -

      -

      - void swap - ( optional<T>& x, optional<T>& y - ) ; -

      -
        -
      • - Requires: Lvalues of type T shall be swappable and T shall be MoveConstructible. -
        • -
      • -

        - Effects: -

        -
        ----- - - - - - - - - - - - - - - - - - - -
        - -

        - *this contains a value -

        -         		-

        - *this does not contain a value -

        -
        -

        - rhs - contains a value -

        -         		-

        - calls swap(*(*this), *rhs) -

        -         		-

        - initializes the contained value of *this as if direct-initializing - an object of type T - with the expression std::move(*rhs), followed by rhs.val->T::~T(), - *this - contains a value and rhs - does not contain a value -

        -
        -

        - rhs - does not contain a value -

        -         		-

        - initializes the contained value of rhs - as if direct-initializing an object of type T with the expression - std::move(*(*this)), - followed by val->T::~T(), *this does not contain a value - and rhs contains - a value -

        -         		-

        - no effect -

        -
        -
        • -
      • - Postconditions: The states of x and y - interchanged. -
        • -
      • - Throws: If both are initialized, whatever - swap(T&,T&) - throws. If only one is initialized, whatever T::T ( T&& ) - throws. -
        • -
      • - Example: -
        T x(12);
-T y(21);
-optional<T> def0 ;
-optional<T> def1 ;
-optional<T> optX(x);
-optional<T> optY(y);
-
-boost::swap(def0,def1); // no-op
-
-boost::swap(def0,optX);
-assert ( *def0 == x );
-assert ( !optX );
-
-boost::swap(def0,optX); // Get back to original values
-
-boost::swap(optX,optY);
-assert ( *optX == y );
-assert ( *optY == x );
-
        -
        • -
      -

      - space -

      -

      - void swap - ( optional<T&>& x, optional<T&>& y - ) noexcept - ; -

      -
        -
      • - Postconditions: x - refers to what y referred - to before the swap (if anything). y - refers to whatever x - referred to before the swap. -
        • -
      • - Example: -
        T x(12);
-T y(21);
-
-optional<T&> opt0;
-optional<T&> optX (x);
-optional<T&> optY (y);
-
-boost::swap(optX, optY);
-assert (addressof(*optX) == addressof(y));
-assert (addressof(*optY) == addressof(x));
-
-boost::swap(opt0, optX);
-assert ( opt0 );
-assert ( !optX );
-assert (addressof(*opt0) == addressof(y));
-
        - [endsect] -
        • -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2016 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____free_functions.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____free_functions.html deleted file mode 100644 index b3c6401d..00000000 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____free_functions.html +++ /dev/null @@ -1,447 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - space -

      -

      - optional<T> make_optional( - T const& v ) -

      -
        -
      • - Returns: optional<T>(v) for the deduced - type T of v. -
        • -
      • - Example: -
        template<class T> void foo ( optional<T> const& opt ) ;
-
-foo ( make_optional(1+1) ) ; // Creates an optional<int>
-
        -
        • -
      -

      - space -

      -

      - optional<T (not a ref)> make_optional( bool condition, - T const& v ) -

      -
        -
      • - Returns: optional<T>(condition,v) for the deduced - type T of v. -
        • -
      • - Example: -
        optional<double> calculate_foo()
-{
-  double val = compute_foo();
-  return make_optional(is_not_nan_and_finite(val),val);
-}
-
-optional<double> v = calculate_foo();
-if ( !v )
-  error("foo wasn't computed");
-
        -
        • -
      -

      - space -

      -

      - bool operator - == ( - optional<T> const& x, optional<T> const& y ); -

      -
        -
      • - Requires: T - shall meet requirements of EqualityComparable. -
        • -
      • - Returns: If both x - and y are initialized, - (*x - == *y). - If only x or y is initialized, false. - If both are uninitialized, true. -
        • -
      • - Notes: This definition guarantees - that optional<T> - not containing a value is compared unequal to any optional<T> containing any value, and equal - to any other optional<T> not containing a value. Pointers - have shallow relational operators while optional - has deep relational operators. Do not use operator== directly in generic code which expect - to be given either an optional<T> or a pointer; use equal_pointees() - instead -
        • -
      • - Example: -
        optional<T> oN, oN_;
-optional<T> o1(T(1)), o1_(T(1));
-optional<T> o2(T(2));
-
-assert ( oN == oN );  // Identity implies equality
-assert ( o1 == o1 );  //
-
-assert ( oN == oN_ ); // Both uninitialized compare equal
-
-assert ( oN != o1 );  // Initialized unequal to initialized.
-
-assert ( o1 == o1_ ); // Both initialized compare as (*lhs == *rhs)
-assert ( o1 != o2 );  //
-
        -
        • -
      -

      - space -

      -

      - bool operator - < ( - optional<T> const& x, optional<T> const& y ); -

      -
        -
      • - Requires: Expression *x < *y shall be well-formed and its result - shall be convertible to bool. -
        • -
      • - Returns: (!y) ? false : (!x) ? true : *x < - *y. -
        • -
      • - Notes: This definition guarantees - that optional<T> - not containing a value is ordered as less than any optional<T> containing any value, and equivalent - to any other optional<T> not containing a value. Pointers - have shallow relational operators while optional - has deep relational operators. Do not use operator< directly in generic code which - expect to be given either an optional<T> or a pointer; use less_pointees() - instead. T need not - be LessThanComparable. Only - single operator< - is required. Other relational operations are defined in terms of this - one. If T's operator< - satisfies the axioms of LessThanComparable (transitivity, - antisymmetry and irreflexivity), optional<T> is LessThanComparable. -
        • -
      • - Example: -
        optional<T> oN, oN_;
-optional<T> o0(T(0));
-optional<T> o1(T(1));
-
-assert ( !(oN < oN) );  // Identity implies equivalence
-assert ( !(o1 < o1) );
-
-assert ( !(oN < oN_) ); // Two uninitialized are equivalent
-assert ( !(oN_ < oN) );
-
-assert ( oN < o0 );     // Uninitialized is less than initialized
-assert ( !(o0 < oN) );
-
-assert ( o1 < o2 ) ;    // Two initialized compare as (*lhs < *rhs)
-assert ( !(o2 < o1) ) ;
-assert ( !(o2 < o2) ) ;
-
        -
        • -
      -

      - space -

      -

      - bool operator - != ( - optional<T> const& x, optional<T> const& y ); -

      -
      • - Returns: !( - x == - y ); -
      -

      - space -

      -

      - bool operator - > ( - optional<T> const& x, optional<T> const& y ); -

      -
      • - Returns: ( - y < - x ); -
      -

      - space -

      -

      - bool operator - <= ( - optional<T> const& x, optional<T> const& y ); -

      -
      • - Returns: !( - y < - x ); -
      -

      - space -

      -

      - bool operator - >= ( - optional<T> const& x, optional<T> const& y ); -

      -
      • - Returns: !( - x < - y ); -
      -

      - space -

      -

      - bool operator - == ( - optional<T> const& x, none_t ) - noexcept; -

      -

      - bool operator - == ( - none_t, - optional<T> const& x ) noexcept; -

      -
      -

      - space -

      -

      - bool operator - != ( - optional<T> const& x, none_t ) - noexcept; -

      -

      - bool operator - != ( - none_t, - optional<T> const& x ) noexcept; -

      -
      • - Returns: !( - x == - y ); -
      -

      - space -

      -

      - void swap - ( optional<T>& x, optional<T>& y - ) ; -

      -
        -
      • - Requires: Lvalues of type T shall be swappable and T shall be MoveConstructible. -
        • -
      • -

        - Effects: -

        -
        ----- - - - - - - - - - - - - - - - - - - -
        - -

        - *this contains a value -

        -         		-

        - *this does not contain a value -

        -
        -

        - rhs - contains a value -

        -         		-

        - calls swap(*(*this), *rhs) -

        -         		-

        - initializes the contained value of *this as if direct-initializing - an object of type T - with the expression std::move(*rhs), followed by rhs.val->T::~T(), - *this - contains a value and rhs - does not contain a value -

        -
        -

        - rhs - does not contain a value -

        -         		-

        - initializes the contained value of rhs - as if direct-initializing an object of type T with the expression - std::move(*(*this)), - followed by val->T::~T(), *this does not contain a value - and rhs contains - a value -

        -         		-

        - no effect -

        -
        -
        • -
      • - Postconditions: The states of x and y - interchanged. -
        • -
      • - Throws: If both are initialized, whatever - swap(T&,T&) - throws. If only one is initialized, whatever T::T ( T&& ) - throws. -
        • -
      • - Example: -
        T x(12);
-T y(21);
-optional<T> def0 ;
-optional<T> def1 ;
-optional<T> optX(x);
-optional<T> optY(y);
-
-boost::swap(def0,def1); // no-op
-
-boost::swap(def0,optX);
-assert ( *def0 == x );
-assert ( !optX );
-
-boost::swap(def0,optX); // Get back to original values
-
-boost::swap(optX,optY);
-assert ( *optX == y );
-assert ( *optY == x );
-
        -
        • -
      -

      - space -

      -

      - void swap - ( optional<T&>& x, optional<T&>& y - ) noexcept - ; -

      -
        -
      • - Postconditions: x - refers to what y referred - to before the swap (if anything). y - refers to whatever x - referred to before the swap. -
        • -
      • - Example: -
        T x(12);
-T y(21);
-
-optional<T&> opt0;
-optional<T&> optX (x);
-optional<T&> optY (y);
-
-boost::swap(optX, optY);
-assert (addressof(*optX) == addressof(y));
-assert (addressof(*optY) == addressof(x));
-
-boost::swap(opt0, optX);
-assert ( opt0 );
-assert ( !optX );
-assert (addressof(*opt0) == addressof(y));
-
        - [endsect] -
        • -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2016 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____optional_references.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____optional_references.html deleted file mode 100644 index 7eedfaba..00000000 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____optional_references.html +++ /dev/null @@ -1,57 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - space -

      -

      - optional<&>::optional() - noexcept; -

      -

      - optional<&>::optional(none_t) noexcept; -

      -
      • - Postconditions: *this refers to nothing. -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2016 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____optional_values.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____optional_values.html deleted file mode 100644 index 17eeb386..00000000 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics____optional_values.html +++ /dev/null @@ -1,1983 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      - - - - - -
      [Note]Note

      - The following section contains various assert() which are used only to show the postconditions - as sample code. It is not implied that the type T - must support each particular expression but that if the expression is - supported, the implied condition holds. -

      -

      - space -

      -

      - optional<T>::optional() - noexcept; -

      -
        -
      • - Effect: Default-Constructs an optional. -
        • -
      • - Postconditions: *this is uninitialized. -
        • -
      • - Notes: T's default constructor is not called. -
        • -
      • - Example: -
        optional<T> def ;
-assert ( !def ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T>::optional( - none_t ) - noexcept; -

      -
        -
      • - Effect: Constructs an optional uninitialized. -
        • -
      • - Postconditions: *this is uninitialized. -
        • -
      • - Notes: T's - default constructor is not called. - The expression boost::none - denotes an instance of boost::none_t - that can be used as the parameter. -
        • -
      • - Example: -
        #include <boost/none.hpp>
-optional<T> n(none) ;
-assert ( !n ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T (not a ref)>::optional( T const& v ) -

      -
        -
      • - Requires: is_copy_constructible<T>::value - is true. -
        • -
      • - Effect: Directly-Constructs an optional. -
        • -
      • - Postconditions: *this is initialized - and its value is a copy of v. -
        • -
      • - Throws: Whatever T::T( T const& - ) throws. -
        • -
      • - Notes: T::T( T const& - ) is called. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T const& - ); in that case, this constructor - has no effect. -
        • -
      • - Example: -
        T v;
-optional<T> opt(v);
-assert ( *opt == v ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>::optional( - T& - ref ) -

      -
        -
      • - Effect: Directly-Constructs an optional. -
        • -
      • - Postconditions: *this is initialized - and its value is an instance of an internal type wrapping the reference - ref. -
        • -
      • - Throws: Nothing. -
        • -
      • - Example: -
        T v;
-T& vref = v ;
-optional<T&> opt(vref);
-assert ( *opt == v ) ;
-++ v ; // mutate referee
-assert (*opt == v);
-
        -
        • -
      -

      - space -

      -

      - optional<T (not a ref)>::optional( T&& v - ) -

      -
        -
      • - Requires: is_move_constructible<T>::value - is true. -
        • -
      • - Effect: Directly-Move-Constructs an - optional. -
        • -
      • - Postconditions: *this is initialized - and its value is move-constructed from v. -
        • -
      • - Throws: Whatever T::T( T&& ) - throws. -
        • -
      • - Notes: T::T( T&& ) - is called. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T&& ); - in that case, the state of v - is determined by exception safety guarantees for T::T(T&&). -
        • -
      • - Example: -
        T v1, v2;
-optional<T> opt(std::move(v1));
-assert ( *opt == v2 ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>::optional( - T&& - ref ) - = delete -

      -
      • - Notes: This constructor is deleted -
      -

      - space -

      -

      - optional<T (not a ref)>::optional( bool condition, - T const& v ) ; -

      -

      - optional<T&> - ::optional( bool condition, - T& - v ) - ; -

      -
      • - If condition is true, same as: -
      -

      - optional<T (not a ref)>::optional( T const& v ) -

      -

      - optional<T&> - ::optional( T& v ) -

      -
      • - otherwise, same as: -
      -

      - optional<T (not a ref)>::optional() -

      -

      - optional<T&> - ::optional() -

      -

      - space -

      -

      - optional<T (not a ref)>::optional( optional - const& - rhs ); -

      -
        -
      • - Requires: is_copy_constructible<T>::value - is true. -
        • -
      • - Effect: Copy-Constructs an optional. -
        • -
      • - Postconditions: If rhs is initialized, - *this - is initialized and its value is a copy of the - value of rhs; else - *this - is uninitialized. -
        • -
      • - Throws: Whatever T::T( T const& - ) throws. -
        • -
      • - Notes: If rhs is initialized, T::T(T const& ) - is called. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T const& - ); in that case, this constructor - has no effect. -
        • -
      • - Example: -
        optional<T> uninit ;
-assert (!uninit);
-
-optional<T> uinit2 ( uninit ) ;
-assert ( uninit2 == uninit );
-
-optional<T> init( T(2) );
-assert ( *init == T(2) ) ;
-
-optional<T> init2 ( init ) ;
-assert ( init2 == init ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>::optional( - optional const& rhs - ); -

      -
        -
      • - Effect: Copy-Constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is another reference to the same object - referenced by *rhs; - else *this - is uninitialized. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: If rhs - is initialized, both *this and *rhs will refer to the same object - (they alias). -
        • -
      • - Example: -
        optional<T&> uninit ;
-assert (!uninit);
-
-optional<T&> uinit2 ( uninit ) ;
-assert ( uninit2 == uninit );
-
-T v = 2 ; T& ref = v ;
-optional<T> init(ref);
-assert ( *init == v ) ;
-
-optional<T> init2 ( init ) ;
-assert ( *init2 == v ) ;
-
-v = 3 ;
-
-assert ( *init  == 3 ) ;
-assert ( *init2 == 3 ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T (not a ref)>::optional( optional&& rhs - ) noexcept(see below); -

      -
        -
      • - Requires: is_move_constructible<T>::value - is true. -
        • -
      • - Effect: Move-constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is move constructed from rhs; else *this is uninitialized. -
        • -
      • - Throws: Whatever T::T( T&& ) - throws. -
        • -
      • - Remarks: The expression inside noexcept is equivalent to is_nothrow_move_constructible<T>::value. -
        • -
      • - Notes: If rhs - is initialized, T::T( T && - ) is called. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T&& ); - in that case, rhs remains - initialized and the value of *rhs is determined by exception safety - of T::T(T&&). -
        • -
      • - Example: -
        optional<std::unique_ptr<T>> uninit ;
-assert (!uninit);
-
-optional<std::unique_ptr<T>> uinit2 ( std::move(uninit) ) ;
-assert ( uninit2 == uninit );
-
-optional<std::unique_ptr<T>> init( std::unique_ptr<T>(new T(2)) );
-assert ( **init == T(2) ) ;
-
-optional<std::unique_ptr<T>> init2 ( std::move(init) ) ;
-assert ( init );
-assert ( *init == nullptr );
-assert ( init2 );
-assert ( **init2 == T(2) ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>::optional( - optional && - rhs ); -

      -
        -
      • - Effect: Move-Constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is another reference to the same object - referenced by *rhs; - else *this - is uninitialized. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: If rhs - is initialized, both *this and *rhs will refer to the same object - (they alias). -
        • -
      • - Example: -
        optional<std::unique_ptr<T>&> uninit ;
-assert (!uninit);
-
-optional<std::unique_ptr<T>&> uinit2 ( std::move(uninit) ) ;
-assert ( uninit2 == uninit );
-
-std::unique_ptr<T> v(new T(2)) ;
-optional<std::unique_ptr<T>&> init(v);
-assert ( *init == v ) ;
-
-optional<std::unique_ptr<T>&> init2 ( std::move(init) ) ;
-assert ( *init2 == v ) ;
-
-*v = 3 ;
-
-assert ( **init  == 3 ) ;
-assert ( **init2 == 3 ) ;
-
        -
        • -
      -

      - space -

      -

      - template<U> explicit optional<T - (not a ref)>::optional( - optional<U> const& rhs ); -

      -
        -
      • - Effect: Copy-Constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is a copy of the - value of rhs converted to type T; - else *this - is uninitialized. -
        • -
      • - Throws: Whatever T::T( U const& - ) throws. -
        • -
      • - Notes: T::T( U const& - ) is called if rhs is initialized, which requires - a valid conversion from U - to T. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( U const& - ); in that case, this constructor - has no effect. -
        • -
      • - Example: -
        optional<double> x(123.4);
-assert ( *x == 123.4 ) ;
-
-optional<int> y(x) ;
-assert( *y == 123 ) ;
-
        -
        • -
      -

      - space -

      -

      - template<U> explicit optional<T - (not a ref)>::optional( - optional<U>&& - rhs ); -

      -
        -
      • - Effect: Move-constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is move-constructed from *rhs; - else *this - is uninitialized. -
        • -
      • - Throws: Whatever T::T( U&& ) - throws. -
        • -
      • - Notes: T::T( U&& ) - is called if rhs is - initialized, which requires a valid conversion from U - to T. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( U&& ); - in that case, rhs remains - initialized and the value of *rhs is determined by exception safety - guarantee of T::T( U&& - ). -
        • -
      • - Example: -
        optional<double> x(123.4);
-assert ( *x == 123.4 ) ;
-
-optional<int> y(std::move(x)) ;
-assert( *y == 123 ) ;
-
        -
        • -
      -

      - space -

      -

      - template<InPlaceFactory> - explicit optional<T - (not a ref)>::optional( - InPlaceFactory const& f ); -

      -

      - template<TypedInPlaceFactory> - explicit optional<T - (not a ref)>::optional( - TypedInPlaceFactory const& f ); -

      -
        -
      • - Effect: Constructs an optional with a value of T obtained from the factory. -
        • -
      • - Postconditions: *this is initialized - and its value is directly given from the factory - f (i.e., the value - is not copied). -
        • -
      • - Throws: Whatever the T constructor called by the factory - throws. -
        • -
      • - Notes: See In-Place - Factories -
        • -
      • - Exception Safety: Exceptions can only - be thrown during the call to the T - constructor used by the factory; in that case, this constructor has - no effect. -
        • -
      • - Example: -
        class C { C ( char, double, std::string ) ; } ;
-
-C v('A',123.4,"hello");
-
-optional<C> x( in_place   ('A', 123.4, "hello") ); // InPlaceFactory used
-optional<C> y( in_place<C>('A', 123.4, "hello") ); // TypedInPlaceFactory used
-
-assert ( *x == v ) ;
-assert ( *y == v ) ;
-
        -
        • -
      -

      - space -

      -

      - optional& - optional<T>::operator= ( none_t - ) noexcept; -

      -
        -
      • - Effect: If *this is initialized destroys its contained - value. -
        • -
      • - Postconditions: *this is uninitialized. -
        • -
      -

      - space -

      -

      - optional& - optional<T (not a ref)>::operator= ( T - const& - rhs ) - ; -

      -
        -
      • - Effect: Assigns the value rhs to an optional. -
        • -
      • - Postconditions: *this is initialized and its value is - a copy of rhs. -
        • -
      • - Throws: Whatever T::operator=( T const& - ) or T::T(T const&) - throws. -
        • -
      • - Notes: If *this was initialized, T's assignment operator is used, - otherwise, its copy-constructor is used. -
        • -
      • - Exception Safety: In the event of - an exception, the initialization state of *this is unchanged and its value unspecified - as far as optional - is concerned (it is up to T's - operator=()). - If *this - is initially uninitialized and T's - copy constructor fails, *this is left properly uninitialized. -
        • -
      • - Example: -
        T x;
-optional<T> def ;
-optional<T> opt(x) ;
-
-T y;
-def = y ;
-assert ( *def == y ) ;
-opt = y ;
-assert ( *opt == y ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>& - optional<T&>::operator= ( T& rhs - ) ; -

      -
        -
      • - Effect: (Re)binds the wrapped reference. -
        • -
      • - Postconditions: *this is initialized and it references - the same object referenced by rhs. -
        • -
      • - Notes: If *this was initialized, it is rebound - to the new object. See here - for details on this behavior. -
        • -
      • - Example: -
        int a = 1 ;
-int b = 2 ;
-T& ra = a ;
-T& rb = b ;
-optional<int&> def ;
-optional<int&> opt(ra) ;
-
-def = rb ; // binds 'def' to 'b' through 'rb'
-assert ( *def == b ) ;
-*def = a ; // changes the value of 'b' to a copy of the value of 'a'
-assert ( b == a ) ;
-int c = 3;
-int& rc = c ;
-opt = rc ; // REBINDS to 'c' through 'rc'
-c = 4 ;
-assert ( *opt == 4 ) ;
-
        -
        • -
      -

      - space -

      -

      - optional& - optional<T (not a ref)>::operator= ( T&& rhs - ) ; -

      -
        -
      • - Effect: Moves the value rhs to an optional. -
        • -
      • - Postconditions: *this is initialized and its value is - moved from rhs. -
        • -
      • - Throws: Whatever T::operator=( T&& ) - or T::T(T &&) - throws. -
        • -
      • - Notes: If *this was initialized, T's move-assignment operator is used, - otherwise, its move-constructor is used. -
        • -
      • - Exception Safety: In the event of - an exception, the initialization state of *this is unchanged and its value unspecified - as far as optional - is concerned (it is up to T's - operator=()). - If *this - is initially uninitialized and T's - move constructor fails, *this is left properly uninitialized. -
        • -
      • - Example: -
        T x;
-optional<T> def ;
-optional<T> opt(x) ;
-
-T y1, y2, yR;
-def = std::move(y1) ;
-assert ( *def == yR ) ;
-opt = std::move(y2) ;
-assert ( *opt == yR ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&>& - optional<T&>::operator= ( T&& rhs - ) = - delete; -

      -
      • - Notes: This assignment operator is - deleted. -
      -

      - space -

      -

      - optional& - optional<T (not a ref)>::operator= ( optional - const& - rhs ) - ; -

      -
        -
      • - Requires: T - is CopyConstructible and CopyAssignable. -
        • -
      • -

        - Effects: -

        -
        ----- - - - - - - - - - - - - - - - - - - -
        - -

        - *this contains a value -

        -         		-

        - *this does not contain a value -

        -
        -

        - rhs - contains a value -

        -         		-

        - assigns *rhs - to the contained value -

        -         		-

        - initializes the contained value as if direct-initializing - an object of type T - with *rhs -

        -
        -

        - rhs - does not contain a value -

        -         		-

        - destroys the contained value by calling val->T::~T() -

        -         		-

        - no effect -

        -
        -
        • -
      • - Returns: *this; -
        • -
      • - Postconditions: bool(rhs) == bool(*this). -
        • -
      • - Exception Safety: If any exception - is thrown, the initialization state of *this and rhs - remains unchanged. If an exception is thrown during the call to T's copy constructor, no effect. - If an exception is thrown during the call to T's - copy assignment, the state of its contained value is as defined by - the exception safety guarantee of T's - copy assignment. -
        • -
      • - Example: -
        T v;
-optional<T> opt(v);
-optional<T> def ;
-
-opt = def ;
-assert ( !def ) ;
-// previous value (copy of 'v') destroyed from within 'opt'.
-
        -
        • -
      -

      - space -

      -

      - optional<T&> - & optional<T&>::operator= ( optional<T&> const& rhs - ) ; -

      -
        -
      • - Effect: (Re)binds thee wrapped reference. -
        • -
      • - Postconditions: If *rhs is initialized, *this - is initialized and it references the same object referenced by *rhs; - otherwise, *this - is uninitialized (and references no object). -
        • -
      • - Notes: If *this was initialized and so is *rhs, - *this - is rebound to the new object. See here - for details on this behavior. -
        • -
      • - Example: -
        int a = 1 ;
-int b = 2 ;
-T& ra = a ;
-T& rb = b ;
-optional<int&> def ;
-optional<int&> ora(ra) ;
-optional<int&> orb(rb) ;
-
-def = orb ; // binds 'def' to 'b' through 'rb' wrapped within 'orb'
-assert ( *def == b ) ;
-*def = ora ; // changes the value of 'b' to a copy of the value of 'a'
-assert ( b == a ) ;
-int c = 3;
-int& rc = c ;
-optional<int&> orc(rc) ;
-ora = orc ; // REBINDS ora to 'c' through 'rc'
-c = 4 ;
-assert ( *ora == 4 ) ;
-
        -
        • -
      -

      - space -

      -

      - optional& - optional<T (not a ref)>::operator= ( optional&& rhs - ) noexcept(see below); -

      -
        -
      • - Requires: T - is MoveConstructible - and MoveAssignable. -
        • -
      • -

        - Effects: -

        -
        ----- - - - - - - - - - - - - - - - - - - -
        - -

        - *this contains a value -

        -         		-

        - *this does not contain a value -

        -
        -

        - rhs - contains a value -

        -         		-

        - assigns std::move(*rhs) to the contained value -

        -         		-

        - initializes the contained value as if direct-initializing - an object of type T - with std::move(*rhs) -

        -
        -

        - rhs - does not contain a value -

        -         		-

        - destroys the contained value by calling val->T::~T() -

        -         		-

        - no effect -

        -
        -
        • -
      • - Returns: *this; -
        • -
      • - Postconditions: bool(rhs) == bool(*this). -
        • -
      • - Remarks: The expression inside noexcept is equivalent to is_nothrow_move_constructible<T>::value && - is_nothrow_move_assignable<T>::value. -
        • -
      • - Exception Safety: If any exception - is thrown, the initialization state of *this and rhs - remains unchanged. If an exception is thrown during the call to T's move constructor, the state of - *rhs - is determined by the exception safety guarantee of T's - move constructor. If an exception is thrown during the call to T's - move-assignment, the state of **this and *rhs is determined by the exception - safety guarantee of T's move assignment. -
        • -
      • - Example: -
        optional<T> opt(T(2)) ;
-optional<T> def ;
-
-opt = def ;
-assert ( def ) ;
-assert ( opt ) ;
-assert ( *opt == T(2) ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T&> - & optional<T&>::operator= ( optional<T&>&& rhs - ) ; -

      -
      • - Effect: Same as optional<T&>::operator= ( optional<T&> - const& - rhs ). -
      -

      - space -

      -

      - template<U> optional& - optional<T (not a ref)>::operator= ( optional<U> const& rhs - ) ; -

      -
        -
      • -

        - Effect: -

        -
        ----- - - - - - - - - - - - - - - - - - - -
        - -

        - *this contains a value -

        -         		-

        - *this does not contain a value -

        -
        -

        - rhs - contains a value -

        -         		-

        - assigns *rhs - to the contained value -

        -         		-

        - initializes the contained value as if direct-initializing - an object of type T - with *rhs -

        -
        -

        - rhs - does not contain a value -

        -         		-

        - destroys the contained value by calling val->T::~T() -

        -         		-

        - no effect -

        -
        -
        • -
      • - Returns: *this. -
        • -
      • - Postconditions: bool(rhs) == bool(*this). -
        • -
      • - Exception Safety: If any exception - is thrown, the result of the expression bool(*this) remains unchanged. If an exception - is thrown during the call to T's - constructor, no effect. If an exception is thrown during the call to - T's assignment, the - state of its contained value is as defined by the exception safety - guarantee of T's copy - assignment. -
        • -
      • - Example: -
        T v;
-optional<T> opt0(v);
-optional<U> opt1;
-
-opt1 = opt0 ;
-assert ( *opt1 == static_cast<U>(v) ) ;
-
        -
        • -
      -

      - space -

      -

      - template<U> optional& - optional<T (not a ref)>::operator= ( optional<U>&& rhs - ) ; -

      -
        -
      • -

        - Effect: -

        -
        ----- - - - - - - - - - - - - - - - - - - -
        - -

        - *this contains a value -

        -         		-

        - *this does not contain a value -

        -
        -

        - rhs - contains a value -

        -         		-

        - assigns std::move(*rhs) to the contained value -

        -         		-

        - initializes the contained value as if direct-initializing - an object of type T - with std::move(*rhs) -

        -
        -

        - rhs - does not contain a value -

        -         		-

        - destroys the contained value by calling val->T::~T() -

        -         		-

        - no effect -

        -
        -
        • -
      • - Returns: *this. -
        • -
      • - Postconditions: bool(rhs) == bool(*this). -
        • -
      • - Exception Safety: If any exception - is thrown, the result of the expression bool(*this) remains unchanged. If an exception - is thrown during the call to T's - constructor, no effect. If an exception is thrown during the call to - T's assignment, the - state of its contained value is as defined by the exception safety - guarantee of T's copy - assignment. -
        • -
      • - Example: -
        T v;
-optional<T> opt0(v);
-optional<U> opt1;
-
-opt1 = std::move(opt0) ;
-assert ( opt0 );
-assert ( opt1 )
-assert ( *opt1 == static_cast<U>(v) ) ;
-
        -
        • -
      -

      - space -

      -

      - template<class... Args> - void optional<T - (not a ref)>::emplace( - Args...&& - args ); -

      -
        -
      • - Requires: The compiler supports rvalue - references and variadic templates. -
        • -
      • - Effect: If *this is initialized calls *this = none. - Then initializes in-place the contained value as if direct-initializing - an object of type T - with std::forward<Args>(args).... -
        • -
      • - Postconditions: *this is initialized. -
        • -
      • - Throws: Whatever the selected T's constructor throws. -
        • -
      • - Exception Safety: If an exception - is thrown during the initialization of T, - *this - is uninitialized. -
        • -
      • - Notes: T - need not be MoveConstructible - or MoveAssignable. - On compilers that do not support variadic templates, the signature - falls back to two overloads:template<class - Arg> - void emplace(Arg&& arg) and void - emplace(). - On compilers that do not support rvalue references, the signature falls - back to three overloads: taking const - and non-const lvalue reference, - and third with empty function argument list. -
        • -
      • - Example: -
        T v;
-optional<const T> opt;
-opt.emplace(0);  // create in-place using ctor T(int)
-opt.emplace();   // destroy previous and default-construct another T
-opt.emplace(v);  // destroy and copy-construct in-place (no assignment called)
-
        -
        • -
      -

      - space -

      -

      - template<InPlaceFactory> - optional<T>& - optional<T (not a ref)>::operator=( InPlaceFactory - const& - f ); -

      -

      - template<TypedInPlaceFactory> - optional<T>& - optional<T (not a ref)>::operator=( TypedInPlaceFactory - const& - f ); -

      -
        -
      • - Effect: Assigns an optional - with a value of T obtained - from the factory. -
        • -
      • - Postconditions: *this is initialized - and its value is directly given from the factory - f (i.e., the value - is not copied). -
        • -
      • - Throws: Whatever the T constructor called by the factory - throws. -
        • -
      • - Notes: See In-Place - Factories -
        • -
      • - Exception Safety: Exceptions can only - be thrown during the call to the T - constructor used by the factory; in that case, the optional - object will be reset to be uninitialized. -
        • -
      -

      - space -

      -

      - void optional<T - (not a ref)>::reset( T const& v ) ; -

      -
      • - Deprecated: same as operator= - ( T - const& - v) - ; -
      -

      - space -

      -

      - void optional<T>::reset() noexcept - ; -

      -
      • - Deprecated: Same as operator=( - none_t ); -
      -

      - space -

      -

      - T const& optional<T - (not a ref)>::get() const ; -

      -

      - T& - optional<T (not a ref)>::get() ; -

      -

      - inline T - const& - get ( - optional<T (not a ref)> const& ) ; -

      -

      - inline T& get - ( optional<T - (not a ref)> - &) ; -

      -
        -
      • - Requires: *this is initialized -
        • -
      • - Returns: A reference to the contained - value -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). -
        • -
      -

      - space -

      -

      - T const& optional<T&>::get() const ; -

      -

      - T& - optional<T&>::get() ; -

      -

      - inline T - const& - get ( - optional<T&> - const& - ) ; -

      -

      - inline T& get - ( optional<T&> &) - ; -

      -
        -
      • - Requires: *this is initialized -
        • -
      • - Returns: The - reference contained. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). -
        • -
      -

      - space -

      -

      - T const& optional<T - (not a ref)>::operator*() - const& - ; -

      -

      - T& - optional<T (not a ref)>::operator*() &; -

      -
        -
      • - Requires: *this is initialized -
        • -
      • - Returns: A reference to the contained - value -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). - On compilers that do not support ref-qualifiers on member functions - these two overloads are replaced with the classical two: a const and non-const - member functions. -
        • -
      • - Example: -
        T v ;
-optional<T> opt ( v );
-T const& u = *opt;
-assert ( u == v ) ;
-T w ;
-*opt = w ;
-assert ( *opt == w ) ;
-
        -
        • -
      -

      - space -

      -

      - T&& - optional<T (not a ref)>::operator*() &&; -

      -
        -
      • - Requires: *this contains a value. -
        • -
      • - Effects: Equivalent to return std::move(*val);. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). - On compilers that do not support ref-qualifiers on member functions - this overload is not present. -
        • -
      -

      - space -

      -

      - T & - optional<T&>::operator*() - const& - ; -

      -

      - T & - optional<T&>::operator*() - & ; -

      -

      - T & - optional<T&>::operator*() - && ; -

      -
        -
      • - Requires: *this is initialized -
        • -
      • - Returns: The - reference contained. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). - On compilers that do not support ref-qualifiers on member functions - these three overloads are replaced with the classical two: a const and non-const - member functions. -
        • -
      • - Example: -
        T v ;
-T& vref = v ;
-optional<T&> opt ( vref );
-T const& vref2 = *opt;
-assert ( vref2 == v ) ;
-++ v ;
-assert ( *opt == v ) ;
-
        -
        • -
      -

      - space -

      -

      - T const& optional<T>::value() const& ; -

      -

      - T& - optional<T>::value() & ; -

      -
        -
      • - Effects: Equivalent to return bool(*this) ? *val : throw bad_optional_access();. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions these two overloads are replaced - with the classical two: a const - and non-const member functions. -
        • -
      • - Example: -
        T v ;
-optional<T> o0, o1 ( v );
-assert ( o1.value() == v );
-
-try {
-  o0.value(); // throws
-  assert ( false );
-}
-catch(bad_optional_access&) {
-  assert ( true );
-}
-
        -
        • -
      -

      - space -

      -

      - T&& - optional<T>::value() && ; -

      -
        -
      • - Effects: Equivalent to return bool(*this) ? std::move(*val) : throw bad_optional_access();. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions this overload is not present. -
        • -
      -

      - space -

      -

      - template<class U> T optional<T>::value_or(U && - v) - const& - ; -

      -
        -
      • - Effects: Equivalent to if (*this) return **this; else return - std::forward<U>(v);. -
        • -
      • - Remarks: If T - is not CopyConstructible or U && - is not convertible to T, - the program is ill-formed. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions this overload is replaced with the - const-qualified member - function. On compilers without rvalue reference support the type of - v becomes U const&. -
        • -
      -

      - space -

      -

      - template<class U> T optional<T>::value_or(U && - v) - && ; -

      -
        -
      • - Effects: Equivalent to if (*this) return std::move(**this); else return std::forward<U>(v);. -
        • -
      • - Remarks: If T - is not MoveConstructible - or U && - is not convertible to T, - the program is ill-formed. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions this overload is not present. -
        • -
      -

      - space -

      -

      - template<class F> T optional<T>::value_or_eval(F f) const& ; -

      -
        -
      • - Requires: T - is CopyConstructible and F models a Generator whose result type - is convertible to T. -
        • -
      • - Effects: if - (*this) return **this; else return f();. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions this overload is replaced with the - const-qualified member - function. -
        • -
      • - Example: -
        int complain_and_0()
-{
-  clog << "no value returned, using default" << endl;
-  return 0;
-}
-
-optional<int> o1 = 1;
-optional<int> oN = none;
-
-int i = o1.value_or_eval(complain_and_0); // fun not called
-assert (i == 1);
-
-int j = oN.value_or_eval(complain_and_0); // fun called
-assert (i == 0);
-
        -
        • -
      -

      - space -

      -

      - template<class F> T optional<T>::value_or_eval(F f) && - ; -

      -
        -
      • - Requires: T - is MoveConstructible - and F models a Generator - whose result type is convertible to T. -
        • -
      • - Effects: if - (*this) return std::move(**this); else return - f();. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions this overload is not present. -
        • -
      -

      - space -

      -

      - T const& optional<T - (not a ref)>::get_value_or( - T const& default) const ; -

      -

      - T& - optional<T (not a ref)>::get_value_or( T& default - ) ; -

      -

      - inline T - const& - get_optional_value_or ( - optional<T (not a ref)> const& o, T const& default ) ; -

      -

      - inline T& get_optional_value_or - ( optional<T - (not a ref)>& - o, - T& - default ) - ; -

      -
        -
      • - Deprecated: Use value_or() instead. -
        • -
      • - Returns: A reference to the contained - value, if any, or default. -
        • -
      • - Throws: Nothing. -
        • -
      • - Example: -
        T v, z ;
-optional<T> def;
-T const& y = def.get_value_or(z);
-assert ( y == z ) ;
-
-optional<T> opt ( v );
-T const& u = get_optional_value_or(opt,z);
-assert ( u == v ) ;
-assert ( u != z ) ;
-
        -
        • -
      -

      - space -

      -

      - T const* optional<T - (not a ref)>::get_ptr() - const ; -

      -

      - T* - optional<T (not a ref)>::get_ptr() ; -

      -

      - inline T - const* - get_pointer ( - optional<T (not a ref)> const& ) ; -

      -

      - inline T* get_pointer - ( optional<T - (not a ref)> - &) ; -

      -
        -
      • - Returns: If *this is initialized, a pointer to the - contained value; else 0 - (null). -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The contained value is permanently - stored within *this, - so you should not hold nor delete this pointer -
        • -
      • - Example: -
        T v;
-optional<T> opt(v);
-optional<T> const copt(v);
-T* p = opt.get_ptr() ;
-T const* cp = copt.get_ptr();
-assert ( p == get_pointer(opt) );
-assert ( cp == get_pointer(copt) ) ;
-
        -
        • -
      -

      - space -

      -

      - T const* optional<T - (not a ref)>::operator ->() - const ; -

      -

      - T* - optional<T (not a ref)>::operator - ->() ; -

      -
        -
      • - Requires: *this is initialized. -
        • -
      • - Returns: A pointer to the contained - value. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). -
        • -
      • - Example: -
        struct X { int mdata ; } ;
-X x ;
-optional<X> opt (x);
-opt->mdata = 2 ;
-
        -
        • -
      -

      - space -

      -

      - explicit optional<T>::operator - bool() - const noexcept - ; -

      -
        -
      • - Returns: get_ptr() != 0. -
        • -
      • - Notes: On compilers that do not support - explicit conversion operators this falls back to safe-bool idiom. -
        • -
      • - Example: -
        optional<T> def ;
-assert ( def == 0 );
-optional<T> opt ( v ) ;
-assert ( opt );
-assert ( opt != 0 );
-
        -
        • -
      -

      - space -

      -

      - bool optional<T>::operator!() noexcept - ; -

      -
        -
      • - Returns: If *this is uninitialized, true; else false. -
        • -
      • - Notes: This operator is provided for - those compilers which can't use the unspecified-bool-type - operator in certain boolean contexts. -
        • -
      • - Example: -
        optional<T> opt ;
-assert ( !opt );
-*opt = some_T ;
-
-// Notice the "double-bang" idiom here.
-assert ( !!opt ) ;
-
        -
        • -
      -

      - space -

      -

      - bool optional<T>::is_initialized() const ; -

      -
      • - Deprecated: Same as explicit operator - bool () - ; -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2016 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html deleted file mode 100644 index 776cffbb..00000000 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___free_functions.html +++ /dev/null @@ -1,521 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - space -

      -

      - optional<T> make_optional( - T const& v ) -

      -
        -
      • - Returns: optional<T>(v) for the deduced - type T of v. -
        • -
      • - Example: -
        template<class T> void foo ( optional<T> const& opt ) ;
-
-foo ( make_optional(1+1) ) ; // Creates an optional<int>
-
        -
        • -
      -

      - space -

      -

      - optional<std::decay_t<T>> - make_optional( - T && - v ) -

      -
      • - Returns: optional<std::decay_t<T>>(std::move(v)) for the deduced - type T of v. -
      -

      - space -

      -

      - optional<T> make_optional( - bool condition, T const& v ) -

      -
        -
      • - Returns: optional<T>(condition, v) for the deduced - type T of v. -
        • -
      • - Example: -
        optional<double> calculate_foo()
-{
-  double val = compute_foo();
-  return make_optional(is_not_nan_and_finite(val),val);
-}
-
-optional<double> v = calculate_foo();
-if ( !v )
-  error("foo wasn't computed");
-
        -
        • -
      -

      - space -

      -

      - optional<std::decay_t<T>> - make_optional( - bool condition, T && v - ) -

      -
      • - Returns: optional<std::decay_t<T>>(condition, std::move(v)) for the deduced - type T of v. -
      -

      - space -

      -

      - bool operator - == ( - optional<T> const& x, optional<T> const& y ); -

      -
        -
      • - Requires: T - shall meet requirements of EqualityComparable. -
        • -
      • - Returns: If both x - and y are initialized, - (*x - == *y). - If only x or y is initialized, false. - If both are uninitialized, true. -
        • -
      • - Notes: This definition guarantees - that optional<T> - not containing a value is compared unequal to any optional<T> containing any value, and equal - to any other optional<T> not containing a value. Pointers - have shallow relational operators while optional - has deep relational operators. Do not use operator== directly in generic code which expect - to be given either an optional<T> or a pointer; use equal_pointees() - instead -
        • -
      • - Example: -
        optional<T> oN, oN_;
-optional<T> o1(T(1)), o1_(T(1));
-optional<T> o2(T(2));
-
-assert ( oN == oN );  // Identity implies equality
-assert ( o1 == o1 );  //
-
-assert ( oN == oN_ ); // Both uninitialized compare equal
-
-assert ( oN != o1 );  // Initialized unequal to initialized.
-
-assert ( o1 == o1_ ); // Both initialized compare as (*lhs == *rhs)
-assert ( o1 != o2 );  //
-
        -
        • -
      -

      - space -

      -

      - bool operator - < ( - optional<T> const& x, optional<T> const& y ); -

      -
        -
      • - Requires: Expression *x < *y shall be well-formed and its result - shall be convertible to bool. -
        • -
      • - Returns: (!y) ? false : (!x) ? true : *x < - *y. -
        • -
      • - Notes: This definition guarantees - that optional<T> - not containing a value is ordered as less than any optional<T> containing any value, and equivalent - to any other optional<T> not containing a value. Pointers - have shallow relational operators while optional - has deep relational operators. Do not use operator< directly in generic code which - expect to be given either an optional<T> or a pointer; use less_pointees() - instead. T need not - be LessThanComparable. Only - single operator< - is required. Other relational operations are defined in terms of this - one. If T's operator< - satisfies the axioms of LessThanComparable (transitivity, - antisymmetry and irreflexivity), optional<T> is LessThanComparable. -
        • -
      • - Example: -
        optional<T> oN, oN_;
-optional<T> o0(T(0));
-optional<T> o1(T(1));
-
-assert ( !(oN < oN) );  // Identity implies equivalence
-assert ( !(o1 < o1) );
-
-assert ( !(oN < oN_) ); // Two uninitialized are equivalent
-assert ( !(oN_ < oN) );
-
-assert ( oN < o0 );     // Uninitialized is less than initialized
-assert ( !(o0 < oN) );
-
-assert ( o1 < o2 ) ;    // Two initialized compare as (*lhs < *rhs)
-assert ( !(o2 < o1) ) ;
-assert ( !(o2 < o2) ) ;
-
        -
        • -
      -

      - space -

      -

      - bool operator - != ( - optional<T> const& x, optional<T> const& y ); -

      -
      • - Returns: !( - x == - y ); -
      -

      - space -

      -

      - bool operator - > ( - optional<T> const& x, optional<T> const& y ); -

      -
      • - Returns: ( - y < - x ); -
      -

      - space -

      -

      - bool operator - <= ( - optional<T> const& x, optional<T> const& y ); -

      -
      • - Returns: !( - y < - x ); -
      -

      - space -

      -

      - bool operator - >= ( - optional<T> const& x, optional<T> const& y ); -

      -
      • - Returns: !( - x < - y ); -
      -

      - space -

      -

      - bool operator - == ( - optional<T> const& x, none_t ) - noexcept; -

      -

      - bool operator - == ( - none_t, - optional<T> const& x ) noexcept; -

      -
      -

      - space -

      -

      - bool operator - != ( - optional<T> const& x, none_t ) - noexcept; -

      -

      - bool operator - != ( - none_t, - optional<T> const& x ) noexcept; -

      -
      • - Returns: bool(x); -
      -

      - space -

      -

      - auto get_pointer - ( optional<T>& o - ) -> - typename optional<T>::pointer_type - ; -

      -

      - auto get_pointer - ( optional<T> const& o ) -> typename optional<T>::pointer_const_type - ; -

      -
        -
      • - Returns: o.get_ptr(). -
        • -
      • - Throws: Nothing. -
        • -
      -

      - space -

      -

      - auto get_optional_value_or - ( optional<T>& o, typename optional<T>::reference_type def - ) -> - typename optional<T>::reference_type - ; -

      -

      - auto get_optional_value_or - ( optional<T> const& o, typename optional<T>::reference_const_type def - ) -> - typename optional<T>::reference_const_type - ; -

      -
        -
      • - Returns: o.get_value_or(def). -
        • -
      • - Throws: Nothing. -
        • -
      • - Remarks: This function is deprecated. -
        • -
      -

      - space -

      -

      - void swap - ( optional<T>& x, optional<T>& y - ) ; -

      -
        -
      • - Requires: Lvalues of type T shall be swappable and T shall be MoveConstructible. -
        • -
      • -

        - Effects: -

        -
        ----- - - - - - - - - - - - - - - - - - - -
        - -

        - *this contains a value -

        -         		-

        - *this does not contain a value -

        -
        -

        - rhs - contains a value -

        -         		-

        - calls swap(*(*this), *rhs) -

        -         		-

        - initializes the contained value of *this as if direct-initializing - an object of type T - with the expression std::move(*rhs), followed by rhs.val->T::~T(), - *this - contains a value and rhs - does not contain a value -

        -
        -

        - rhs - does not contain a value -

        -         		-

        - initializes the contained value of rhs - as if direct-initializing an object of type T with the expression - std::move(*(*this)), - followed by val->T::~T(), *this does not contain a value - and rhs contains - a value -

        -         		-

        - no effect -

        -
        -
        • -
      • - Postconditions: The states of x and y - interchanged. -
        • -
      • - Throws: If both are initialized, whatever - swap(T&,T&) - throws. If only one is initialized, whatever T::T ( T&& ) - throws. -
        • -
      • - Example: -
        T x(12);
-T y(21);
-optional<T> def0 ;
-optional<T> def1 ;
-optional<T> optX(x);
-optional<T> optY(y);
-
-boost::swap(def0,def1); // no-op
-
-boost::swap(def0,optX);
-assert ( *def0 == x );
-assert ( !optX );
-
-boost::swap(def0,optX); // Get back to original values
-
-boost::swap(optX,optY);
-assert ( *optX == y );
-assert ( *optY == x );
-
        -
        • -
      -

      - space -

      -

      - void swap - ( optional<T&>& x, optional<T&>& y - ) noexcept - ; -

      -
        -
      • - Postconditions: x - refers to what y referred - to before the swap (if anything). y - refers to whatever x - referred to before the swap. -
        • -
      • - Example: -
        T x(12);
-T y(21);
-
-optional<T&> opt0;
-optional<T&> optX (x);
-optional<T&> optY (y);
-
-boost::swap(optX, optY);
-assert (addressof(*optX) == addressof(y));
-assert (addressof(*optY) == addressof(x));
-
-boost::swap(opt0, optX);
-assert ( opt0 );
-assert ( !optX );
-assert (addressof(*opt0) == addressof(y));
-
        -
        • -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html deleted file mode 100644 index 3a4d5fef..00000000 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_references.html +++ /dev/null @@ -1,552 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - space -

      -

      - optional<T&>::optional() - noexcept; -

      -

      - optional<T&>::optional(none_t) noexcept; -

      -
      • - Postconditions: bool(*this) == false; *this refers to nothing. -
      -

      - space -

      -

      - template<class R> optional<T&>::optional(R&& r) noexcept; -

      -
        -
      • - Postconditions: bool(*this) == true; addressof(**this) == addressof(r). -
        • -
      • - Remarks: Unless R - is an lvalue reference, the program is ill-formed. This constructor - does not participate in overload resolution if decay<R> is an instance of boost::optional. -
        • -
      • - Notes: This constructor is declared - explicit on compilers - that do not correctly support binding to const lvalues of integral types. - For more details see here. -
        • -
      • - Example: -
        T v;
-T& vref = v ;
-optional<T&> opt(vref);
-assert ( *opt == v ) ;
-++ v ; // mutate referee
-assert (*opt == v);
-
        -
        • -
      -

      - space -

      -

      - template<class R> optional<T&>::optional(bool cond, R&& - r) - noexcept; -

      -
        -
      • - Effects: Initializes ref with expression cond ? - addressof(r) : nullptr. -
        • -
      • - Postconditions: bool(*this) == cond; If bool(*this), addressof(**this) == addressof(r). -
        • -
      • - Remarks: Unless R - is an lvalue reference, the program is ill-formed. This constructor - does not participate in overload resolution if decay<R> is an instance of boost::optional. -
        • -
      -

      - space -

      -

      - optional<T&>::optional ( - optional const& rhs - ) noexcept - ; -

      -
        -
      • - Effects: Initializes ref with expression rhs.ref. -
        • -
      • - Postconditions: bool(*this) == bool(rhs). -
        • -
      • - Example: -
        optional<T&> uninit ;
-assert (!uninit);
-
-optional<T&> uinit2 ( uninit ) ;
-assert ( uninit2 == uninit );
-
-T v = 2 ; T& ref = v ;
-optional<T> init(ref);
-assert ( *init == v ) ;
-
-optional<T> init2 ( init ) ;
-assert ( *init2 == v ) ;
-
-v = 3 ;
-
-assert ( *init  == 3 ) ;
-assert ( *init2 == 3 ) ;
-
        -
        • -
      -

      - space -

      -

      - template<class U> explicit - optional<T&>::optional ( - optional<U&> - const& - rhs ) - noexcept ; -

      -
        -
      • - Requires: is_convertible<U&, T&>::value - is true. -
        • -
      • - Effects: Initializes ref with expression rhs.ref. -
        • -
      • - Postconditions: bool(*this) == bool(rhs). -
        • -
      -

      - space -

      -

      - optional<T&>::operator= ( none_t - ) noexcept - ; -

      -
        -
      • - Effects: Assigns ref - with expression nullptr. -
        • -
      • - returns: *this. -
        • -
      • - Postconditions: bool(*this) == false. -
        • -
      -

      - optional& - optional<T&>::operator= ( optional - const& - rhs ) - noexcept ; -

      -
        -
      • - Effects: Assigns ref - with expression rhs.ref. -
        • -
      • - returns: *this. -
        • -
      • - Postconditions: bool(*this) == bool(rhs). -
        • -
      • - Notes: This behaviour is called rebinding - semantics. See here - for details. -
        • -
      • - Example: -
        int a = 1 ;
-int b = 2 ;
-T& ra = a ;
-T& rb = b ;
-optional<int&> def ;
-optional<int&> ora(ra) ;
-optional<int&> orb(rb) ;
-
-def = orb ; // binds 'def' to 'b' through 'rb' wrapped within 'orb'
-assert ( *def == b ) ;
-*def = ora ; // changes the value of 'b' to a copy of the value of 'a'
-assert ( b == a ) ;
-int c = 3;
-int& rc = c ;
-optional<int&> orc(rc) ;
-ora = orc ; // REBINDS ora to 'c' through 'rc'
-c = 4 ;
-assert ( *ora == 4 ) ;
-
        -
        • -
      -

      - template<class U> optional& optional<T&>::operator= ( optional<U&> const& rhs - ) noexcept - ; -

      -
        -
      • - Requires: is_convertible<U&, T&>::value - is true. -
        • -
      • - Effects: Assigns ref - with expression rhs.ref. -
        • -
      • - returns: *this. -
        • -
      • - Postconditions: bool(*this) == bool(rhs). -
        • -
      -

      - space -

      -

      - template<class R> optional& optional<T&>::operator= ( R&& r - ) noexcept - ; -

      -
        -
      • - Effects: Assigns ref - with expression r. -
        • -
      • - returns: *this. -
        • -
      • - Postconditions: bool(*this) == true. -
        • -
      • - Remarks: Unless R - is an lvalue reference, the program is ill-formed. This function does - not participate in overload resolution if decay<R> is an instance of boost::optional. -
        • -
      • - Example: -
        int a = 1 ;
-int b = 2 ;
-T& ra = a ;
-T& rb = b ;
-optional<int&> def ;
-optional<int&> opt(ra) ;
-
-def = rb ; // binds 'def' to 'b' through 'rb'
-assert ( *def == b ) ;
-*def = a ; // changes the value of 'b' to a copy of the value of 'a'
-assert ( b == a ) ;
-int c = 3;
-int& rc = c ;
-opt = rc ; // REBINDS to 'c' through 'rc'
-c = 4 ;
-assert ( *opt == 4 ) ;
-
        -
        • -
      -

      - space -

      -

      - void optional<T&>::emplace( R&& r - ) noexcept - ; -

      -
        -
      • - Effects: Assigns ref - with expression r. -
        • -
      • - Postconditions: bool(*this) == true. -
        • -
      • - Remarks: Unless R - is an lvalue reference, the program is ill-formed. This function does - not participate in overload resolution if decay<R> is an instance of boost::optional. -
        • -
      -

      - space -

      -

      - T& - optional<T&>::get() const ; -

      -

      - T& - optional<T&>::operator *() - const ; -

      -
        -
      • - Requires: bool(*this) == true. -
        • -
      • - Effects: Returns *ref. -
        • -
      • - Throws: Nothing. -
        • -
      • - Example: -
        T v ;
-T& vref = v ;
-optional<T&> opt ( vref );
-T const& vref2 = *opt;
-assert ( vref2 == v ) ;
-++ v ;
-assert ( *opt == v ) ;
-
        -
        • -
      -

      - space -

      -

      - T* - optional<T&>::operator -> - () const - ; -

      -
        -
      • - Requires: bool(*this) == true. -
        • -
      • - Effects: Returns ref. -
        • -
      • - Throws: Nothing. -
        • -
      -

      - space -

      -

      - T& - optional<T&>::value() const ; -

      -
      • - Effects: Equivalent to return bool(*this) ? *val : throw bad_optional_access();. -
      -

      - space -

      -

      - template<class R> T& optional<T&>::value_or( R&& r - ) const - noexcept; -

      -
        -
      • - Effects: Equivalent to if (*this) return **this; else return - r;. -
        • -
      • - Remarks: Unless R - is an lvalue reference, the program is ill-formed. -
        • -
      -

      - space -

      -

      - template<class F> T& optional<T&>::value_or( F f ) const ; -

      -
        -
      • - Effects: Equivalent to if (*this) return **this; else return - f();. -
        • -
      • - Remarks: Unless decltype(f()) is an lvalue reference, the program - is ill-formed. -
        • -
      -

      - space -

      -

      - template<class F> auto optional<T&>::map( F f ) const -> see below; -

      -
        -
      • - Effects: Equivalent to if (*this) return f(**this); else return none;. -
        • -
      • - Remarks: The return type of this function - is optional<decltype(f(**this))>. -
        • -
      -

      - space -

      -

      - template<class F> auto optional<T&>::flat_map( - F f - ) const - -> see below; -

      -
        -
      • - Requires: The return type of expression - f(**this) - is optional<U> - for some object or reference type U. -
        • -
      • - Effects: Equivalent to if (*this) return f(**this); else return none;. -
        • -
      • - Remarks: The return type of this function - is optional<U>. -
        • -
      -

      - space -

      -

      - T* - optional<T&>::get_ptr () - const noexcept; -

      -
      • - Returns: ref. -
      -

      - space -

      -

      - bool has_value() const noexcept; -

      -

      - optional<T&>::operator bool - () const - noexcept; -

      -
      • - Returns: bool(ref). -
      -

      - space -

      -

      - optional<T&>::operator ! () const noexcept; -

      -
      • - Returns: !bool(ref). -
      -

      - space -

      -

      - void optional<T&>::reset() noexcept; -

      -
      • - Effects: Same as *this = none. -
      -

      - space -

      -

      - template<class R> void optional<T&>::reset ( R&& - r) - noexcept; -

      -
        -
      • - Effects: Equivalent to *this = std::forward<R>(r). -
        • -
      • - Remarks: This function is deprecated. -
        • -
      -

      - space -

      -

      - bool optional<T&>::is_initialized() const noexcept; -

      -
        -
      • - Effects: Equivalent to return bool(*this). -
        • -
      • - Remarks: This function is deprecated. -
        • -
      -

      - space -

      -

      - template<class R> T& optional<T&>::get_value_or( R&& r - ) const - noexcept; -

      -
        -
      • - Effects: Equivalent to return value_or(std::forward<R>(r);. -
        • -
      • - Remarks: This function is deprecated. -
        • -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html deleted file mode 100644 index ce614066..00000000 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/detailed_semantics___optional_values.html +++ /dev/null @@ -1,1788 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      - - - - - -
      [Note]Note

      - The following section contains various assert() which are used only to show the postconditions - as sample code. It is not implied that the type T - must support each particular expression but that if the expression is - supported, the implied condition holds. -

      -

      - space -

      -

      - optional<T>::optional() - noexcept; -

      -
        -
      • - Effect: Default-Constructs an optional. -
        • -
      • - Postconditions: *this is uninitialized. -
        • -
      • - Notes: T's default constructor is not called. -
        • -
      • - Example: -
        optional<T> def ;
-assert ( !def ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T>::optional( - none_t ) - noexcept; -

      -
        -
      • - Effect: Constructs an optional uninitialized. -
        • -
      • - Postconditions: *this is uninitialized. -
        • -
      • - Notes: T's - default constructor is not called. - The expression boost::none - denotes an instance of boost::none_t - that can be used as the parameter. -
        • -
      • - Example: -
        #include <boost/none.hpp>
-optional<T> n(none) ;
-assert ( !n ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T>::optional( - T const& v ) -

      -
        -
      • - Requires: is_copy_constructible<T>::value - is true. -
        • -
      • - Effect: Directly-Constructs an optional. -
        • -
      • - Postconditions: *this is initialized - and its value is a copy of v. -
        • -
      • - Throws: Whatever T::T( T const& - ) throws. -
        • -
      • - Notes: T::T( T const& - ) is called. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T const& - ); in that case, this constructor - has no effect. -
        • -
      • - Example: -
        T v;
-optional<T> opt(v);
-assert ( *opt == v ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T>::optional( - T&& - v ) -

      -
        -
      • - Requires: is_move_constructible<T>::value - is true. -
        • -
      • - Effect: Directly-Move-Constructs an - optional. -
        • -
      • - Postconditions: *this is initialized - and its value is move-constructed from v. -
        • -
      • - Throws: Whatever T::T( T&& ) - throws. -
        • -
      • - Notes: T::T( T&& ) - is called. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T&& ); - in that case, the state of v - is determined by exception safety guarantees for T::T(T&&). -
        • -
      • - Example: -
        T v1, v2;
-optional<T> opt(std::move(v1));
-assert ( *opt == v2 ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T>::optional( - bool condition, T const& v ) ; -

      -
      • - If condition is true, same as: -
      -

      - optional<T>::optional( - T const& v ) -

      -
      • - otherwise, same as: -
      -

      - optional<T>::optional() -

      -

      - space -

      -

      - optional<T>::optional( - optional const& rhs - ); -

      -
        -
      • - Requires: is_copy_constructible<T>::value - is true. -
        • -
      • - Effect: Copy-Constructs an optional. -
        • -
      • - Postconditions: If rhs is initialized, - *this - is initialized and its value is a copy of the - value of rhs; else - *this - is uninitialized. -
        • -
      • - Throws: Whatever T::T( T const& - ) throws. -
        • -
      • - Notes: If rhs is initialized, T::T(T const& ) - is called. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T const& - ); in that case, this constructor - has no effect. -
        • -
      • - Example: -
        optional<T> uninit ;
-assert (!uninit);
-
-optional<T> uinit2 ( uninit ) ;
-assert ( uninit2 == uninit );
-
-optional<T> init( T(2) );
-assert ( *init == T(2) ) ;
-
-optional<T> init2 ( init ) ;
-assert ( init2 == init ) ;
-
        -
        • -
      -

      - space -

      -

      - optional<T>::optional( - optional&& - rhs ) - noexcept(see - below); -

      -
        -
      • - Requires: is_move_constructible<T>::value - is true. -
        • -
      • - Effect: Move-constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is move constructed from rhs; else *this is uninitialized. -
        • -
      • - Throws: Whatever T::T( T&& ) - throws. -
        • -
      • - Remarks: The expression inside noexcept is equivalent to is_nothrow_move_constructible<T>::value. -
        • -
      • - Notes: If rhs - is initialized, T::T( T && - ) is called. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( T&& ); - in that case, rhs remains - initialized and the value of *rhs is determined by exception safety - of T::T(T&&). -
        • -
      • - Example: -
        optional<std::unique_ptr<T>> uninit ;
-assert (!uninit);
-
-optional<std::unique_ptr<T>> uinit2 ( std::move(uninit) ) ;
-assert ( uninit2 == uninit );
-
-optional<std::unique_ptr<T>> init( std::unique_ptr<T>(new T(2)) );
-assert ( **init == T(2) ) ;
-
-optional<std::unique_ptr<T>> init2 ( std::move(init) ) ;
-assert ( init );
-assert ( *init == nullptr );
-assert ( init2 );
-assert ( **init2 == T(2) ) ;
-
        -
        • -
      -

      - space -

      -

      - template<U> explicit optional<T>::optional( optional<U> const& rhs - ); -

      -
        -
      • - Effect: Copy-Constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is a copy of the - value of rhs converted to type T; - else *this - is uninitialized. -
        • -
      • - Throws: Whatever T::T( U const& - ) throws. -
        • -
      • - Notes: T::T( U const& - ) is called if rhs is initialized, which requires - a valid conversion from U - to T. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( U const& - ); in that case, this constructor - has no effect. -
        • -
      • - Example: -
        optional<double> x(123.4);
-assert ( *x == 123.4 ) ;
-
-optional<int> y(x) ;
-assert( *y == 123 ) ;
-
        -
        • -
      -

      - space -

      -

      - template<U> explicit optional<T>::optional( optional<U>&& rhs - ); -

      -
        -
      • - Effect: Move-constructs an optional. -
        • -
      • - Postconditions: If rhs - is initialized, *this - is initialized and its value is move-constructed from *rhs; - else *this - is uninitialized. -
        • -
      • - Throws: Whatever T::T( U&& ) - throws. -
        • -
      • - Notes: T::T( U&& ) - is called if rhs is - initialized, which requires a valid conversion from U - to T. -
        • -
      • - Exception Safety: Exceptions can only - be thrown during T::T( U&& ); - in that case, rhs remains - initialized and the value of *rhs is determined by exception safety - guarantee of T::T( U&& - ). -
        • -
      • - Example: -
        optional<double> x(123.4);
-assert ( *x == 123.4 ) ;
-
-optional<int> y(std::move(x)) ;
-assert( *y == 123 ) ;
-
        -
        • -
      -

      - space -

      -

      - template<class... Args> - explicit optional<T>::optional( in_place_init_t, Args&&... ars - ); -

      -
        -
      • - Requires: is_constructible_v<T, Args&&...> is true. -
        • -
      • - Effect: Initializes the contained - value as if direct-non-list-initializing an object of type T with the arguments std::forward<Args>(args).... -
        • -
      • - Postconditions: *this is initialized. -
        • -
      • - Throws: Any exception thrown by the - selected constructor of T. -
        • -
      • - Notes: T - need not be MoveConstructible. - On compilers that do not support variadic templates or rvalue references, - this constuctor is available in limited functionality. For details - see here. -
        • -
      • - Example: -
        // creates an std::mutex using its default constructor
-optional<std::mutex> om {in_place_init};
-assert (om);
-
-// creates a unique_lock by calling unique_lock(*om, std::defer_lock)
-optional<std::unique_lock<std::mutex>> ol {in_place_init, *om, std::defer_lock};
-assert (ol);
-assert (!ol->owns_lock());
-
        -
        • -
      -

      - space -

      -

      - template<class... Args> - explicit optional<T>::optional( in_place_init_if_t, bool condition, - Args&&... - ars ); -

      -
        -
      • - Requires: is_constructible_v<T, Args&&...> is true. -
        • -
      • - Effect: If condition - is true, initializes the - contained value as if direct-non-list-initializing an object of type - T with the arguments - std::forward<Args>(args).... -
        • -
      • - Postconditions: bool(*this) == condition. -
        • -
      • - Throws: Any exception thrown by the - selected constructor of T. -
        • -
      • - Notes: T - need not be MoveConstructible. - On compilers that do not support variadic templates or rvalue references, - this constuctor is available in limited functionality. For details - see here. -
        • -
      • - Example: -
        optional<std::vector<std::string>> ov1 {in_place_init_if, false, 3, "A"};
-assert (!ov1);
-
-optional<std::vector<std::string>> ov2 {in_place_init_if, true, 3, "A"};
-assert (ov2);
-assert (ov2->size() == 3);
-
        -
        • -
      -

      - space -

      -

      - template<InPlaceFactory> - explicit optional<T>::optional( InPlaceFactory - const& - f ); -

      -

      - template<TypedInPlaceFactory> - explicit optional<T>::optional( TypedInPlaceFactory - const& - f ); -

      -
        -
      • - Effect: Constructs an optional with a value of T obtained from the factory. -
        • -
      • - Postconditions: *this is initialized - and its value is directly given from the factory - f (i.e., the value - is not copied). -
        • -
      • - Throws: Whatever the T constructor called by the factory - throws. -
        • -
      • - Notes: See In-Place - Factories -
        • -
      • - Exception Safety: Exceptions can only - be thrown during the call to the T - constructor used by the factory; in that case, this constructor has - no effect. -
        • -
      • - Example: -
        class C { C ( char, double, std::string ) ; } ;
-
-C v('A',123.4,"hello");
-
-optional<C> x( in_place   ('A', 123.4, "hello") ); // InPlaceFactory used
-optional<C> y( in_place<C>('A', 123.4, "hello") ); // TypedInPlaceFactory used
-
-assert ( *x == v ) ;
-assert ( *y == v ) ;
-
        -
        • -
      -

      - space -

      -

      - optional& - optional<T>::operator= ( none_t - ) noexcept; -

      -
        -
      • - Effect: If *this is initialized destroys its contained - value. -
        • -
      • - Postconditions: *this is uninitialized. -
        • -
      -

      - space -

      -

      - optional& - optional<T>::operator= ( T const& rhs ) ; -

      -
        -
      • - Effect: Assigns the value rhs to an optional. -
        • -
      • - Postconditions: *this is initialized and its value is - a copy of rhs. -
        • -
      • - Throws: Whatever T::operator=( T const& - ) or T::T(T const&) - throws. -
        • -
      • - Notes: If *this was initialized, T's assignment operator is used, - otherwise, its copy-constructor is used. -
        • -
      • - Exception Safety: In the event of - an exception, the initialization state of *this is unchanged and its value unspecified - as far as optional - is concerned (it is up to T's - operator=()). - If *this - is initially uninitialized and T's - copy constructor fails, *this is left properly uninitialized. -
        • -
      • - Example: -
        T x;
-optional<T> def ;
-optional<T> opt(x) ;
-
-T y;
-def = y ;
-assert ( *def == y ) ;
-opt = y ;
-assert ( *opt == y ) ;
-
        -
        • -
      -

      - space -

      -

      - optional& - optional<T>::operator= ( T&& rhs - ) ; -

      -
        -
      • - Effect: Moves the value rhs to an optional. -
        • -
      • - Postconditions: *this is initialized and its value is - moved from rhs. -
        • -
      • - Throws: Whatever T::operator=( T&& ) - or T::T(T &&) - throws. -
        • -
      • - Notes: If *this was initialized, T's move-assignment operator is used, - otherwise, its move-constructor is used. -
        • -
      • - Exception Safety: In the event of - an exception, the initialization state of *this is unchanged and its value unspecified - as far as optional - is concerned (it is up to T's - operator=()). - If *this - is initially uninitialized and T's - move constructor fails, *this is left properly uninitialized. -
        • -
      • - Example: -
        T x;
-optional<T> def ;
-optional<T> opt(x) ;
-
-T y1, y2, yR;
-def = std::move(y1) ;
-assert ( *def == yR ) ;
-opt = std::move(y2) ;
-assert ( *opt == yR ) ;
-
        -
        • -
      -

      - space -

      -

      - optional& - optional<T>::operator= ( optional - const& - rhs ) - ; -

      -
        -
      • - Requires: T - is CopyConstructible and CopyAssignable. -
        • -
      • -

        - Effects: -

        -
        ----- - - - - - - - - - - - - - - - - - - -
        - -

        - *this contains a value -

        -         		-

        - *this does not contain a value -

        -
        -

        - rhs - contains a value -

        -         		-

        - assigns *rhs - to the contained value -

        -         		-

        - initializes the contained value as if direct-initializing - an object of type T - with *rhs -

        -
        -

        - rhs - does not contain a value -

        -         		-

        - destroys the contained value by calling val->T::~T() -

        -         		-

        - no effect -

        -
        -
        • -
      • - Returns: *this; -
        • -
      • - Postconditions: bool(rhs) == bool(*this). -
        • -
      • - Exception Safety: If any exception - is thrown, the initialization state of *this and rhs - remains unchanged. If an exception is thrown during the call to T's copy constructor, no effect. - If an exception is thrown during the call to T's - copy assignment, the state of its contained value is as defined by - the exception safety guarantee of T's - copy assignment. -
        • -
      • - Example: -
        T v;
-optional<T> opt(v);
-optional<T> def ;
-
-opt = def ;
-assert ( !def ) ;
-// previous value (copy of 'v') destroyed from within 'opt'.
-
        -
        • -
      -

      - space -

      -

      - optional& - optional<T>::operator= ( optional&& rhs - ) noexcept(see below); -

      -
        -
      • - Requires: T - is MoveConstructible - and MoveAssignable. -
        • -
      • -

        - Effects: -

        -
        ----- - - - - - - - - - - - - - - - - - - -
        - -

        - *this contains a value -

        -         		-

        - *this does not contain a value -

        -
        -

        - rhs - contains a value -

        -         		-

        - assigns std::move(*rhs) to the contained value -

        -         		-

        - initializes the contained value as if direct-initializing - an object of type T - with std::move(*rhs) -

        -
        -

        - rhs - does not contain a value -

        -         		-

        - destroys the contained value by calling val->T::~T() -

        -         		-

        - no effect -

        -
        -
        • -
      • - Returns: *this; -
        • -
      • - Postconditions: bool(rhs) == bool(*this). -
        • -
      • - Remarks: The expression inside noexcept is equivalent to is_nothrow_move_constructible<T>::value && - is_nothrow_move_assignable<T>::value. -
        • -
      • - Exception Safety: If any exception - is thrown, the initialization state of *this and rhs - remains unchanged. If an exception is thrown during the call to T's move constructor, the state of - *rhs - is determined by the exception safety guarantee of T's - move constructor. If an exception is thrown during the call to T's - move-assignment, the state of **this and *rhs is determined by the exception - safety guarantee of T's move assignment. -
        • -
      • - Example: -
        optional<T> opt(T(2)) ;
-optional<T> def ;
-
-opt = def ;
-assert ( def ) ;
-assert ( opt ) ;
-assert ( *opt == T(2) ) ;
-
        -
        • -
      -

      - space -

      -

      - template<U> optional& - optional<T>::operator= ( optional<U> const& rhs - ) ; -

      -
        -
      • -

        - Effect: -

        -
        ----- - - - - - - - - - - - - - - - - - - -
        - -

        - *this contains a value -

        -         		-

        - *this does not contain a value -

        -
        -

        - rhs - contains a value -

        -         		-

        - assigns *rhs - to the contained value -

        -         		-

        - initializes the contained value as if direct-initializing - an object of type T - with *rhs -

        -
        -

        - rhs - does not contain a value -

        -         		-

        - destroys the contained value by calling val->T::~T() -

        -         		-

        - no effect -

        -
        -
        • -
      • - Returns: *this. -
        • -
      • - Postconditions: bool(rhs) == bool(*this). -
        • -
      • - Exception Safety: If any exception - is thrown, the result of the expression bool(*this) remains unchanged. If an exception - is thrown during the call to T's - constructor, no effect. If an exception is thrown during the call to - T's assignment, the - state of its contained value is as defined by the exception safety - guarantee of T's copy - assignment. -
        • -
      • - Example: -
        T v;
-optional<T> opt0(v);
-optional<U> opt1;
-
-opt1 = opt0 ;
-assert ( *opt1 == static_cast<U>(v) ) ;
-
        -
        • -
      -

      - space -

      -

      - template<U> optional& - optional<T>::operator= ( optional<U>&& rhs - ) ; -

      -
        -
      • -

        - Effect: -

        -
        ----- - - - - - - - - - - - - - - - - - - -
        - -

        - *this contains a value -

        -         		-

        - *this does not contain a value -

        -
        -

        - rhs - contains a value -

        -         		-

        - assigns std::move(*rhs) to the contained value -

        -         		-

        - initializes the contained value as if direct-initializing - an object of type T - with std::move(*rhs) -

        -
        -

        - rhs - does not contain a value -

        -         		-

        - destroys the contained value by calling val->T::~T() -

        -         		-

        - no effect -

        -
        -
        • -
      • - Returns: *this. -
        • -
      • - Postconditions: bool(rhs) == bool(*this). -
        • -
      • - Exception Safety: If any exception - is thrown, the result of the expression bool(*this) remains unchanged. If an exception - is thrown during the call to T's - constructor, no effect. If an exception is thrown during the call to - T's assignment, the - state of its contained value is as defined by the exception safety - guarantee of T's copy - assignment. -
        • -
      • - Example: -
        T v;
-optional<T> opt0(v);
-optional<U> opt1;
-
-opt1 = std::move(opt0) ;
-assert ( opt0 );
-assert ( opt1 )
-assert ( *opt1 == static_cast<U>(v) ) ;
-
        -
        • -
      -

      - space -

      -

      - template<class... Args> - void optional<T>::emplace( Args&&... args - ); -

      -
        -
      • - Requires: The compiler supports rvalue - references and variadic templates. -
        • -
      • - Effect: If *this is initialized calls *this = none. - Then initializes in-place the contained value as if direct-initializing - an object of type T - with std::forward<Args>(args).... -
        • -
      • - Postconditions: *this is initialized. -
        • -
      • - Throws: Whatever the selected T's constructor throws. -
        • -
      • - Exception Safety: If an exception - is thrown during the initialization of T, - *this - is uninitialized. -
        • -
      • - Notes: T - need not be MoveConstructible - or MoveAssignable. - On compilers that do not support variadic templates or rvalue references, - this function is available in limited functionality. For details see here. -
        • -
      • - Example: -
        T v;
-optional<const T> opt;
-opt.emplace(0);  // create in-place using ctor T(int)
-opt.emplace();   // destroy previous and default-construct another T
-opt.emplace(v);  // destroy and copy-construct in-place (no assignment called)
-
        -
        • -
      -

      - space -

      -

      - template<InPlaceFactory> - optional<T>& - optional<T>::operator=( InPlaceFactory const& f ); -

      -

      - template<TypedInPlaceFactory> - optional<T>& - optional<T>::operator=( TypedInPlaceFactory const& f ); -

      -
        -
      • - Effect: Assigns an optional - with a value of T obtained - from the factory. -
        • -
      • - Postconditions: *this is initialized - and its value is directly given from the factory - f (i.e., the value - is not copied). -
        • -
      • - Throws: Whatever the T constructor called by the factory - throws. -
        • -
      • - Notes: See In-Place - Factories -
        • -
      • - Exception Safety: Exceptions can only - be thrown during the call to the T - constructor used by the factory; in that case, the optional - object will be reset to be uninitialized. -
        • -
      -

      - space -

      -

      - void optional<T>::reset( T const& v ) ; -

      -
      • - Deprecated: same as operator= - ( T - const& - v) - ; -
      -

      - space -

      -

      - void optional<T>::reset() noexcept - ; -

      -
      • - Effects: Same as operator=( none_t - ); -
      -

      - space -

      -

      - T const& optional<T>::get() const ; -

      -

      - T& - optional<T>::get() ; -

      -

      - inline T - const& - get ( - optional<T> const& ) ; -

      -

      - inline T& get - ( optional<T> &) - ; -

      -
        -
      • - Requires: *this is initialized -
        • -
      • - Returns: A reference to the contained - value -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). -
        • -
      -

      - space -

      -

      - T const& optional<T>::operator*() const& ; -

      -

      - T& - optional<T>::operator*() - &; -

      -
        -
      • - Requires: *this is initialized -
        • -
      • - Returns: A reference to the contained - value -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). - On compilers that do not support ref-qualifiers on member functions - these two overloads are replaced with the classical two: a const and non-const - member functions. -
        • -
      • - Example: -
        T v ;
-optional<T> opt ( v );
-T const& u = *opt;
-assert ( u == v ) ;
-T w ;
-*opt = w ;
-assert ( *opt == w ) ;
-
        -
        • -
      -

      - space -

      -

      - T&& - optional<T>::operator*() - &&; -

      -
        -
      • - Requires: *this contains a value. -
        • -
      • - Effects: Equivalent to return std::move(*val);. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). - On compilers that do not support ref-qualifiers on member functions - this overload is not present. -
        • -
      -

      - space -

      -

      - T const& optional<T>::value() const& ; -

      -

      - T& - optional<T>::value() & ; -

      -
        -
      • - Effects: Equivalent to return bool(*this) ? *val : throw bad_optional_access();. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions these two overloads are replaced - with the classical two: a const - and non-const member functions. -
        • -
      • - Example: -
        T v ;
-optional<T> o0, o1 ( v );
-assert ( o1.value() == v );
-
-try {
-  o0.value(); // throws
-  assert ( false );
-}
-catch(bad_optional_access&) {
-  assert ( true );
-}
-
        -
        • -
      -

      - space -

      -

      - T&& - optional<T>::value() && ; -

      -
        -
      • - Effects: Equivalent to return bool(*this) ? std::move(*val) : throw bad_optional_access();. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions this overload is not present. -
        • -
      -

      - space -

      -

      - template<class U> T optional<T>::value_or(U && - v) - const& - ; -

      -
        -
      • - Effects: Equivalent to if (*this) return **this; else return - std::forward<U>(v);. -
        • -
      • - Remarks: If T - is not CopyConstructible or U && - is not convertible to T, - the program is ill-formed. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions this overload is replaced with the - const-qualified member - function. On compilers without rvalue reference support the type of - v becomes U const&. -
        • -
      -

      - space -

      -

      - template<class U> T optional<T>::value_or(U && - v) - && ; -

      -
        -
      • - Effects: Equivalent to if (*this) return std::move(**this); else return std::forward<U>(v);. -
        • -
      • - Remarks: If T - is not MoveConstructible - or U && - is not convertible to T, - the program is ill-formed. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions this overload is not present. -
        • -
      -

      - space -

      -

      - template<class F> T optional<T>::value_or_eval(F f) const& ; -

      -
        -
      • - Requires: T - is CopyConstructible and F models a Generator whose result type - is convertible to T. -
        • -
      • - Effects: if - (*this) return **this; else return f();. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions this overload is replaced with the - const-qualified member - function. -
        • -
      • - Example: -
        int complain_and_0()
-{
-  clog << "no value returned, using default" << endl;
-  return 0;
-}
-
-optional<int> o1 = 1;
-optional<int> oN = none;
-
-int i = o1.value_or_eval(complain_and_0); // fun not called
-assert (i == 1);
-
-int j = oN.value_or_eval(complain_and_0); // fun called
-assert (i == 0);
-
        -
        • -
      -

      - space -

      -

      - template<class F> T optional<T>::value_or_eval(F f) && - ; -

      -
        -
      • - Requires: T - is MoveConstructible - and F models a Generator - whose result type is convertible to T. -
        • -
      • - Effects: if - (*this) return std::move(**this); else return - f();. -
        • -
      • - Notes: On compilers that do not support - ref-qualifiers on member functions this overload is not present. -
        • -
      -

      - space -

      -

      - template<class F> auto optional<T>::map(F f) const& -> - see below ; -

      -

      - template<class F> auto optional<T>::map(F f) & -> see below - ; -

      -
        -
      • - Effects: if - (*this) return f(**this); else return - none; -
        • -
      • - Notes: The return type of these overloads - is optional<decltype(f(**this))>. - On compilers that do not support ref-qualifiers on member functions, - these two (as well as the next one) overloads are replaced with good - old const and non-const overloads. -
        • -
      • - Example: -
        auto length = [](const string& s){ return s.size(); };
-optional<string> o1 {}, o2 {"cat"};
-optional<size_t> os1 = o1.map(length), os2 = o2.map(length);
-assert ( !os1 ) ;
-assert ( os2 ) ;
-assert ( *os2 == 3 ) ;
-
        -
        • -
      -

      - space -

      -

      - template<class F> auto optional<T>::map(F f) && - -> see below - ; -

      -
        -
      • - Effects: if - (*this) return f(std::move(**this)); else return - none; -
        • -
      • - Notes: The return type of this overload - is optional<decltype(f(istd::move(**this)))>. -
        • -
      -

      - space -

      -

      - template<class F> auto optional<T>::flat_map(F f) const& -> - see below ; -

      -

      - template<class F> auto optional<T>::flat_map(F f) & -> see below - ; -

      -
        -
      • - Requires: The return type of expression - f(**this) - is optional<U> - for some object or reference type U. -
        • -
      • - Effects: if - (*this) return f(**this); else return - none; -
        • -
      • - Notes: The return type of these overloads - is optional<U>. - On compilers that do not support ref-qualifiers on member functions, - these two (as well as the next one) overloads are replaced with good - old const and non-const overloads. -
        • -
      • - Example: -
        optional<char> first_char(const string& s) {
-  return s.empty() ? none : optional<char>(s[0]);
-};
-optional<string> o1 {}, o2 {"cat"};
-optional<char> os1 = o1.flat_map(first_char), os2 = o2.flat_map(first_char);
-assert ( !os1 ) ;
-assert ( os2 ) ;
-assert ( *os2 == 'c' ) ;
-
        - space -
        • -
      -

      - template<class F> auto optional<T>::flat_map(F f) && - -> see below - ; -

      -
        -
      • - Requires: The return type of expression - f(std::move(**this)) - is optional<U> - for some object or reference type U. -
        • -
      • - Effects: if - (*this) return f(std::move(**this)); else return - none; -
        • -
      • - Notes: The return type of this overload - is optional<U>. -
        • -
      -

      - space -

      -

      - T const& optional<T>::get_value_or( T const& default) const ; -

      -

      - T& - optional<T>::get_value_or( - T& - default ) - ; -

      -
        -
      • - Deprecated: Use value_or() instead. -
        • -
      • - Returns: A reference to the contained - value, if any, or default. -
        • -
      • - Throws: Nothing. -
        • -
      • - Example: -
        T v, z ;
-optional<T> def;
-T const& y = def.get_value_or(z);
-assert ( y == z ) ;
-
-optional<T> opt ( v );
-T const& u = opt.get_value_or(z);
-assert ( u == v ) ;
-assert ( u != z ) ;
-
        -
        • -
      -

      - space -

      -

      - T const* optional<T>::get_ptr() const ; -

      -

      - T* - optional<T>::get_ptr() - ; -

      -
        -
      • - Returns: If *this is initialized, a pointer to the - contained value; else 0 - (null). -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The contained value is permanently - stored within *this, - so you should not hold nor delete this pointer -
        • -
      • - Example: -
        T v;
-optional<T> opt(v);
-optional<T> const copt(v);
-T* p = opt.get_ptr() ;
-T const* cp = copt.get_ptr();
-assert ( p == get_pointer(opt) );
-assert ( cp == get_pointer(copt) ) ;
-
        -
        • -
      -

      - space -

      -

      - T const* optional<T>::operator - ->() const - ; -

      -

      - T* - optional<T>::operator ->() - ; -

      -
        -
      • - Requires: *this is initialized. -
        • -
      • - Returns: A pointer to the contained - value. -
        • -
      • - Throws: Nothing. -
        • -
      • - Notes: The requirement is asserted - via BOOST_ASSERT(). -
        • -
      • - Example: -
        struct X { int mdata ; } ;
-X x ;
-optional<X> opt (x);
-opt->mdata = 2 ;
-
        -
        • -
      -

      - space -

      -

      - explicit optional<T>::operator - bool() - const noexcept - ; -

      -

      - bool optional<T>::has_value() const noexcept ; -

      -
        -
      • - Returns: get_ptr() != 0. -
        • -
      • - Notes: On compilers that do not support - explicit conversion operators this falls back to safe-bool idiom. -
        • -
      • - Example: -
        optional<T> def ;
-assert ( def == 0 );
-optional<T> opt ( v ) ;
-assert ( opt );
-assert ( opt != 0 );
-
        -
        • -
      -

      - space -

      -

      - bool optional<T>::operator!() noexcept - ; -

      -
        -
      • - Returns: If *this is uninitialized, true; else false. -
        • -
      • - Notes: This operator is provided for - those compilers which can't use the unspecified-bool-type - operator in certain boolean contexts. -
        • -
      • - Example: -
        optional<T> opt ;
-assert ( !opt );
-*opt = some_T ;
-
-// Notice the "double-bang" idiom here.
-assert ( !!opt ) ;
-
        -
        • -
      -

      - space -

      -

      - bool optional<T>::is_initialized() const ; -

      -
      • - Deprecated: Same as explicit operator - bool () - ; -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header__boost_optional_hpp_.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header__boost_optional_hpp_.html deleted file mode 100644 index 8496d372..00000000 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header__boost_optional_hpp_.html +++ /dev/null @@ -1,47 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - This is an alias for header <boost/optional/optional.hpp>. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2016 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html deleted file mode 100644 index ca73fd90..00000000 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_in_place_init.html +++ /dev/null @@ -1,61 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      namespace boost {
-
-class in_place_init_t { /* see below */ } ;
-const in_place_init_t in_place_init ( /* see below */ ) ;
-
-class in_place_init_if_t { /*see below*/ } ;
-const in_place_init_if_t in_place_init_if ( /*see below*/ ) ;
-
-}
-
      -

      - Classes in_place_init_t - and in_place_init_if_t - are empty classes. Their purpose is to control overload resolution in the - initialization of optional objects. They are empty, trivially copyable - classes with disabled default constructor. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html deleted file mode 100644 index 3244e972..00000000 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_refs.html +++ /dev/null @@ -1,118 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      template <class T>
-class optional<T&> // specialization for lvalue references
-{
-public :
-
-    typedef T& value_type;
-    typedef T& reference_type;
-    typedef T& reference_const_type; // no const propagation
-    typedef T& rval_reference_type;
-    typedef T* pointer_type;
-    typedef T* pointer_const_type;   // no const propagation
-
-    optional () noexcept ; R
-
-    optional ( none_t ) noexcept ; R
-
-    template<class R> optional(R&& r) noexcept ;  R
-
-    template <class R> optional(bool cond, R&& r) noexcept ; R
-
-    optional ( optional const& rhs ) noexcept ; R
-
-    template<class U> explicit optional ( optional<U&> const& rhs ) noexcept ; R
-
-    optional& operator = ( none_t ) noexcept ; R
-
-    optional& operator = ( optional const& rhs ) noexcept; R
-
-    template<class U> optional& operator = ( optional<U&> const& rhs ) noexcept ; R
-
-    template<class R> optional& operator = (R&& r) noexcept ; R
-
-    template<class R> void emplace ( R&& r ) noexcept ; R
-
-    T& get() const ; R
-    T& operator *() const ; R
-
-    T* operator ->() const ; R
-
-    T& value() const& ; R
-
-    template<class R> T& value_or( R && r ) const noexcept ; R
-
-    template<class F> T& value_or_eval( F f ) const ; R
-
-    template<class F> auto map( F f ) const -> see below; R
-
-    template<class F> auto flat_map( F f ) const -> see below; R
-
-    T* get_ptr() const noexcept ; R
-
-    bool has_value() const noexcept ; R
-
-    explicit operator bool() const noexcept ; R
-
-    bool operator!() const noexcept ; R
-
-    void reset() noexcept ; R
-
-    // deprecated methods
-
-    // (deprecated)
-    template<class R> void reset ( R && r ) noexcept ; R
-
-    // (deprecated)
-    bool is_initialized() const noexcept ; R
-
-    // (deprecated)
-    template<class R> T& get_value_or( R && r ) constnoexcept; R
-
-private:
-    T* ref; // exposition only
-};
-
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html b/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html deleted file mode 100644 index 80d648a6..00000000 --- a/doc/html/boost_optional/reference/header__boost_optional_optional_hpp_/header_optional_optional_values.html +++ /dev/null @@ -1,153 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      template <class T>
-class optional
-{
-public :
-
-    typedef T         value_type ;
-    typedef T &       reference_type ;
-    typedef T const&  reference_const_type ;
-    typedef T &&      rval_reference_type ;
-    typedef T *       pointer_type ;
-    typedef T const*  pointer_const_type ;
-
-    optional () noexcept ; R
-
-    optional ( none_t ) noexcept ; R
-
-    optional ( T const& v ) ; R
-
-    optional ( T&& v ) ; R
-
-    optional ( bool condition, T const& v ) ; R
-
-    optional ( optional const& rhs ) ; R
-
-    optional ( optional&& rhs ) noexcept(see below) ; R
-
-    template<class U> explicit optional ( optional<U> const& rhs ) ; R
-
-    template<class U> explicit optional ( optional<U>&& rhs ) ; R
-
-    template<class... Args> explicit optional ( in_place_init_t, Args&&... args ) ; R
-
-    template<class... Args> explicit optional ( in_place_init_if_t, bool condition, Args&&... args ) ; R
-
-    template<class InPlaceFactory> explicit optional ( InPlaceFactory const& f ) ; R
-
-    template<class TypedInPlaceFactory> explicit optional ( TypedInPlaceFactory const& f ) ; R
-
-    optional& operator = ( none_t ) noexcept ; R
-
-    optional& operator = ( T const& v ) ; R
-
-    optional& operator = ( T&& v ) ; R
-
-    optional& operator = ( optional const& rhs ) ; R
-
-    optional& operator = ( optional&& rhs ) noexcept(see below) ; R
-
-    template<class U> optional& operator = ( optional<U> const& rhs ) ; R
-
-    template<class U> optional& operator = ( optional<U>&& rhs ) ; R
-
-    template<class... Args> void emplace ( Args&&... args ) ; R
-
-    template<class InPlaceFactory> optional& operator = ( InPlaceFactory const& f ) ; R
-
-    template<class TypedInPlaceFactory> optional& operator = ( TypedInPlaceFactory const& f ) ; R
-
-    T const& get() const ; R
-    T&       get() ; R
-
-    T const* operator ->() const ; R
-    T*       operator ->() ; R
-
-    T const& operator *() const& ; R
-    T&       operator *() & ; R
-    T&&      operator *() && ; R
-
-    T const& value() const& ; R
-    T&       value() & ; R
-    T&&      value() && ; R
-
-    template<class U> T value_or( U && v ) const& ; R
-    template<class U> T value_or( U && v ) && ; R
-
-    template<class F> T value_or_eval( F f ) const& ; R
-    template<class F> T value_or_eval( F f ) && ; R
-
-    template<class F> auto map( F f ) const& -> see below; R
-    template<class F> auto map( F f ) & -> see below; R
-    template<class F> auto map( F f ) && -> see below; R
-
-    template<class F> auto flat_map( F f ) const& -> see below; R
-    template<class F> auto flat_map( F f ) & -> see below; R
-    template<class F> auto flat_map( F f ) && -> see below; R
-
-    T const* get_ptr() const ; R
-    T*       get_ptr() ; R
-
-    bool has_value() const noexcept ; R
-
-    explicit operator bool() const noexcept ; R
-
-    bool operator!() const noexcept ; R
-
-    void reset() noexcept ; R
-
-    // deprecated methods
-
-    // (deprecated)
-    void reset ( T const& ) ; R
-
-    // (deprecated)
-    bool is_initialized() const ; R
-
-    // (deprecated)
-    T const& get_value_or( T const& default ) const ; R
-};
-
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/io_header.html b/doc/html/boost_optional/reference/io_header.html deleted file mode 100644 index 9b33523a..00000000 --- a/doc/html/boost_optional/reference/io_header.html +++ /dev/null @@ -1,72 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      -
      -

      -

      -
      #include <istream>
-#include <ostream>
-#include <boost/optional/optional.hpp>
-
-namespace boost {
-
-template <class CharType, class CharTrait, class T>
-  std::basic_ostream<CharType, CharTrait>&
-  operator<<(std::basic_ostream<CharType, CharTrait>& out, optional<T> const& v); R
-
-  template <class CharType, class CharTrait>
-  std::basic_ostream<CharType, CharTrait>&
-  operator<<(std::basic_ostream<CharType, CharTrait>& out, none_t const&); R
-
-template<class CharType, class CharTrait, class T>
-  std::basic_istream<CharType, CharTrait>&
-  operator>>(std::basic_istream<CharType, CharTrait>& in, optional<T>& v); R
-
-} // namespace boost
-
      -

      -

      -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/io_header/io_semantics.html b/doc/html/boost_optional/reference/io_header/io_semantics.html deleted file mode 100644 index f74ff4ac..00000000 --- a/doc/html/boost_optional/reference/io_header/io_semantics.html +++ /dev/null @@ -1,112 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - template - <class - CharType, - class CharTrait, class T> -
          std::basic_ostream<CharType, CharTrait>&
          operator<<(std::basic_ostream<CharType, CharTrait>& - out, - optional<T> const& v); -

      -
        -
      • - Effect: Outputs an implementation-defined - string. The output contains the information about whether the optional - object contains a value or not. If v - contains a value, the output contains result of calling out << - *v. -
        • -
      • - Returns: out. -
        • -
      -

      - space -

      -

      - template <class CharType, class CharTrait, - class T>
          std::basic_ostream<CharType, CharTrait>& -
          operator<<(std::basic_ostream<CharType, CharTrait>& out, none_t); -

      -
        -
      • - Effect: Outputs an implementation-defined - string. -
        • -
      • - Returns: out. -
        • -
      -

      - space -

      -

      - template <class CharType, class CharTrait, - class T>
          std::basic_ostream<CharType, CharTrait>& -
          operator>>(std::basic_istream<CharType, CharTrait>& in, optional<T>& v); -

      -
        -
      • - Requires: T - is DefaultConstructible and - MoveConstructible. -
        • -
      • - Effect: Reads the value of optional - object from in. If - the string representation indicates that the optional object should - contain a value, v - contains a value and its contained value is obtained as if by default-constructing - an object o of type - T and then calling - in >> - o; otherwise v does not contain a value, and the - previously contained value (if any) has been destroyed. -
        • -
      • - Returns: out. -
        • -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/reference/relnotes.html b/doc/html/boost_optional/reference/relnotes.html deleted file mode 100644 index c67535ea..00000000 --- a/doc/html/boost_optional/reference/relnotes.html +++ /dev/null @@ -1,183 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      - - Boost Release - X.XX -
      -
      • - Now boost::optional is specialized for reference - parameters. This way the sizeof - of optional reference is that of a pointer, and a number of bugs is avoided. -
      -
      - - Boost Release - 1.60 -
      -
      • - Changed the implementation of boost::none - again. Now it is a const object with internal linkage (as any other tag). - This fixes Trac - #11203. -
      -
      - - Boost Release - 1.59 -
      -
        -
      • - For C++03 compilers, added 0-argument overload for member function emplace(), - and therewith removed the dependency on <boost/utility/in_place_factory.hpp>. -
        • -
      • - Fixed Trac - #11241. -
        • -
      -
      - - Boost Release - 1.58 -
      -
        -
      • - boost::none_t is no longer convertible from - literal 0. This avoids a - bug where optional<rational<int>> - oi = - 0; - would initialize an optional object with no contained value. -
        • -
      • - Improved the trick that prevents streaming out optional - without header optional_io.hpp - by using safe-bool idiom. This addresses Trac - #10825. -
        • -
      • - IOStream operators are now mentioned in documentation. -
        • -
      • - Added a way to manually disable move semantics: just define macro BOOST_OPTIONAL_CONFIG_NO_RVALUE_REFERENCES. - This can be used to work around Trac - #10399. -
        • -
      • - It is no longer possible to assign optional<U> to optional<T> when U - is not assignable or convertible to T - (Trac #11087). -
        • -
      • - Value accessors now work correctly on rvalues of optional<T&> (Trac - #10839). -
        • -
      -
      - - Boost Release - 1.57 -
      -
      • - Git pull #9: - "Supply <string> - to fix C++03 compile error on logic_error("...")". -
      -
      - - Boost Release - 1.56 -
      -
        -
      • - Added support for rvalue references. Now optional<T> works with moveable but non-copyable - T's, -
        • -
      • - Improved swap (now uses - move operations), -
        • -
      • - Added function emplace(). This is the last of the requests from - Trac #1841, -
        • -
      • - optional is moveable, - including conditional noexcept - specifications, which make it move_if_noexcept-friendly, -
        • -
      • - Using explicit operator bool() on platforms that support it (Trac - #4227) (breaking change), -
        • -
      • - Forward declaration of operator<<(ostream&, optional - const&) - to prevent inadvertent incorrect serialization of optional objects, -
        • -
      • - Removed deprecated function reset() from examples (Trac - #9005), -
        • -
      • - Equality comparison with boost::none - does not require that T - be EqualityComparable, -
        • -
      • - Optional rvalue references are explicitly disallowed, -
        • -
      • - Binding temporaries to optional references is explicitly disallowed (breaking - change), -
        • -
      • - More ways to access the contained value, functions value(), value_or(), value_or_eval(), -
        • -
      • - Updated and reorganized documentation, added tutorial and quick guide - sections. -
        • -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2016 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/relnotes.html b/doc/html/boost_optional/relnotes.html deleted file mode 100644 index ae833827..00000000 --- a/doc/html/boost_optional/relnotes.html +++ /dev/null @@ -1,384 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - - Boost - Release 1.79 -

      -
        -
      • - Fixed issue - #98. -
        • -
      • - Fixed issue - #92. -
        • -
      • - Added support for BOOST_NO_IOSTREAM. -
        • -
      • - Now aligned storage uses unsigned - char rather than char - to avoid UB. -
        • -
      • - Now using cv-unqualified value_type - with placement new to avoid - UB. -
        • -
      -

      - - Boost - Release 1.76 -

      -
      • - Fixed MSVC warning C4702. -
      -

      - - Boost - Release 1.75 -

      -
        -
      • - boost::none is constexpr-declared. -
        • -
      • - Fixed issue - #78. -
        • -
      -

      - - Boost - Release 1.73 -

      -
        -
      • - Fixed issue - #78. -
        • -
      • - boost::none is now declared as an inline variable - (on compilers that support it): there is only one instance of boost::none across all translation units. -
        • -
      • - Fixed a number of compilation errors in GCC 4.4.7 in optional<T> for trivial Ts. - Thanks to Robert Leahy for the fix. For details see pr - #78. -
        • -
      • - Now suppressing warning -Wweak-vtables. -
        • -
      -

      - - Boost - Release 1.69 -

      -
        -
      • - Remove deprecation mark from reset() method (without arguments). -
        • -
      • - Fixed issue - #59. -
        • -
      • - Fixed bug with initialization of certain wrapper types in clang with -std=c++03. - See pr #64. -
        • -
      -

      - - Boost - Release 1.68 -

      -
        -
      • - Added member function has_value() for compatibility with std::optional (issue - #52). -
        • -
      • - Added member function map() for transforming optional<T> into optional<U> using a function of type T -> U. -
        • -
      • - Added member function flat_map() for transforming optional<T> into optional<U> using a function of type T -> optional<U>. -
        • -
      -

      - - Boost - Release 1.67 -

      -
        -
      • - Fixed issue - #46. -
        • -
      • - Fixed -Wzero-as-null-pointer-constant warnings. -
        • -
      -

      - - Boost - Release 1.66 -

      -
        -
      • - On newer compilers optional - is now trivially-copyable for scalar Ts. - This uses a different storage (just T - rather than aligned_storage). - We require the compiler to support defaulted functions. -
        • -
      • - Changed the implementation of operator== to get rid of the -Wmaybe-uninitialized false-positive warning - from GCC. -
        • -
      -

      - - Boost - Release 1.63 -

      -
        -
      • - Added two new in-place constructors. They work similarly to emplace() - functions: they initialize the contained value by perfect-forwarding the - obtained arguments. One constructor always initializes the contained value, - the other based on a boolean condition. -
        • -
      • - Syntax o = - {} now correctly un-initializes - optional, just like in std::optional. -
        • -
      • - Fixed Trac #12203. -
        • -
      • - Fixed Trac #12563. -
        • -
      -

      - - Boost - Release 1.62 -

      -
      -

      - - Boost - Release 1.61 -

      -
        -
      • - Now boost::optional is specialized for reference - parameters. This addresses a couple of issues: -
          -
        • - the sizeof of optional - reference is that of a pointer, -
          • -
        • - some bugs connected to copying optional references are gone, -
          • -
        • - all run-time bugs caused by incorrect reference binding on some compilers - are now turned into compile-time errors, -
          • -
        • - you can swap optional references: it is like swapping pointers: shallow, - underlying objects are not affected, -
          • -
        • - optional references to abstract types work. -
          • -
        -
        • -
      • - Documented nested typedefs (Trac - #5193). -
        • -
      • - Made the perfect-forwarding constructor SFINAE-friendly, which fixes Trac #12002. - However, this only works in the newer platforms that correctly implement - C++11 <type_traits>. -
        • -
      • - Fixed Trac #10445. -
        • -
      -

      - - Boost - Release 1.60 -

      -
      • - Changed the implementation of boost::none - again. Now it is a const object with internal linkage (as any other tag). - This fixes Trac - #11203. -
      -

      - - Boost - Release 1.59 -

      -
        -
      • - For C++03 compilers, added 0-argument overload for member function emplace(), - and therewith removed the dependency on <boost/utility/in_place_factory.hpp>. -
        • -
      • - Fixed Trac #11241. -
        • -
      -

      - - Boost - Release 1.58 -

      -
        -
      • - boost::none_t is no longer convertible from - literal 0. This avoids a bug - where optional<rational<int>> oi = 0; would - initialize an optional object with no contained value. -
        • -
      • - Improved the trick that prevents streaming out optional - without header optional_io.hpp - by using safe-bool idiom. This addresses Trac - #10825. -
        • -
      • - IOStream operators are now mentioned in documentation. -
        • -
      • - Added a way to manually disable move semantics: just define macro BOOST_OPTIONAL_CONFIG_NO_RVALUE_REFERENCES. - This can be used to work around Trac - #10399. -
        • -
      • - It is no longer possible to assign optional<U> to optional<T> when U - is not assignable or convertible to T - (Trac #11087). -
        • -
      • - Value accessors now work correctly on rvalues of optional<T&> (Trac - #10839). -
        • -
      -

      - - Boost - Release 1.57 -

      -
      • - Git pull #9: - "Supply <string> - to fix C++03 compile error on logic_error("...")". -
      -

      - - Boost - Release 1.56 -

      -
        -
      • - Added support for rvalue references. Now optional<T> works with moveable but non-copyable - T's, -
        • -
      • - Improved swap (now uses - move operations), -
        • -
      • - Added function emplace(). This is the last of the requests from - Trac #1841, -
        • -
      • - optional is moveable, including - conditional noexcept specifications, - which make it move_if_noexcept-friendly, -
        • -
      • - Using explicit operator bool() on platforms that support it (Trac - #4227) (breaking change), -
        • -
      • - Forward declaration of operator<<(ostream&, optional - const&) - to prevent inadvertent incorrect serialization of optional objects, -
        • -
      • - Removed deprecated function reset() from examples (Trac - #9005), -
        • -
      • - Equality comparison with boost::none - does not require that T - be EqualityComparable, -
        • -
      • - Optional rvalue references are explicitly disallowed, -
        • -
      • - Binding temporaries to optional references is explicitly disallowed (breaking - change), -
        • -
      • - More ways to access the contained value, functions value(), value_or(), value_or_eval(), -
        • -
      • - Updated and reorganized documentation, added tutorial and quick guide sections. -
        • -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/synopsis.html b/doc/html/boost_optional/synopsis.html deleted file mode 100644 index 0de90e79..00000000 --- a/doc/html/boost_optional/synopsis.html +++ /dev/null @@ -1,174 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      // In Header: <boost/optional/optional.hpp>
-
-namespace boost {
-
-template<class T>
-class optional
-{
-    public :
-
-    // (If T is of reference type, the parameters and results by reference are by value)
-
-    optional () noexcept ; R
-
-    optional ( none_t ) noexcept ; R
-
-    optional ( T const& v ) ; R
-
-    optional ( T&& v ) ; R
-
-    // [new in 1.34]
-    optional ( bool condition, T const& v ) ; R
-
-    optional ( optional const& rhs ) ; R
-
-    optional ( optional&& rhs ) noexcept(see below) ; R
-
-    template<class U> explicit optional ( optional<U> const& rhs ) ; R
-
-    template<class U> explicit optional ( optional<U>&& rhs ) ; R
-
-    template<class InPlaceFactory> explicit optional ( InPlaceFactory const& f ) ; R
-
-    template<class TypedInPlaceFactory> explicit optional ( TypedInPlaceFactory const& f ) ; R
-
-    optional& operator = ( none_t ) noexcept ; R
-
-    optional& operator = ( T const& v ) ; R
-
-    optional& operator = ( T&& v ) ; R
-
-    optional& operator = ( optional const& rhs ) ; R
-
-    optional& operator = ( optional&& rhs ) noexcept(see below) ; R
-
-    template<class U> optional& operator = ( optional<U> const& rhs ) ; R
-
-    template<class U> optional& operator = ( optional<U>&& rhs ) ; R
-
-    template<class... Args> void emplace ( Args...&& args ) ; R
-
-    template<class InPlaceFactory> optional& operator = ( InPlaceFactory const& f ) ; R
-
-    template<class TypedInPlaceFactory> optional& operator = ( TypedInPlaceFactory const& f ) ; R
-
-    T const& get() const ; R
-    T&       get() ; R
-
-    T const* operator ->() const ; R
-    T*       operator ->() ; R
-
-    T const& operator *() const& ; R
-    T&       operator *() &; R
-    T&&      operator *() &&; R
-
-    T const& value() const& ; R
-    T&       value() & ; R
-    T&&      value() && ; R
-
-    template<class U> T value_or( U && v ) const& ; R
-    template<class U> T value_or( U && v ) && ; R
-
-    T const* get_ptr() const ; R
-    T*       get_ptr() ; R
-
-    explicit operator bool() const ; R
-
-    bool operator!() const noexcept ; R
-
-    // deprecated methods
-
-    // (deprecated)
-    void reset() noexcept ; R
-
-    // (deprecated)
-    void reset ( T const& ) ; R
-
-    // (deprecated)
-    bool is_initialized() const ; R
-
-    // (deprecated)
-    T const& get_value_or( T const& default ) const ; R
-};
-
-template<class T> inline bool operator == ( optional<T> const& x, optional<T> const& y ) ; R
-
-template<class T> inline bool operator != ( optional<T> const& x, optional<T> const& y ) ; R
-
-template<class T> inline bool operator <  ( optional<T> const& x, optional<T> const& y ) ; R
-
-template<class T> inline bool operator >  ( optional<T> const& x, optional<T> const& y ) ; R
-
-template<class T> inline bool operator <= ( optional<T> const& x, optional<T> const& y ) ; R
-
-template<class T> inline bool operator >= ( optional<T> const& x, optional<T> const& y ) ; R
-
-template<class T> inline bool operator == ( optional<T> const& x, none_t ) noexcept ; R
-
-template<class T> inline bool operator != ( optional<T> const& x, none_t ) noexcept ; R
-
-template<class T> inline optional<T> make_optional ( T const& v ) ; R
-
-template<class T> inline optional<T> make_optional ( bool condition, T const& v ) ; R
-
-template<class T> inline T const& get_optional_value_or ( optional<T> const& opt, T const& default ) ; R
-
-template<class T> inline T const& get ( optional<T> const& opt ) ; R
-
-template<class T> inline T& get ( optional<T> & opt ) ; R
-
-template<class T> inline T const* get ( optional<T> const* opt ) ; R
-
-template<class T> inline T* get ( optional<T>* opt ) ; R
-
-template<class T> inline T const* get_pointer ( optional<T> const& opt ) ; R
-
-template<class T> inline T* get_pointer ( optional<T> & opt ) ; R
-
-template<class T> inline void swap( optional<T>& x, optional<T>& y ) ; R
-
-} // namespace boost
-
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial.html b/doc/html/boost_optional/tutorial.html deleted file mode 100644 index 9cee12a2..00000000 --- a/doc/html/boost_optional/tutorial.html +++ /dev/null @@ -1,523 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      -
      Motivation
      -
      Design Overview
      -
      -
      -
      -

      - Consider these functions which should return a value but which might not - have a value to return: -

      -
        -
      • - (A) double sqrt(double n ); -
        • -
      • - (B) char get_async_input(); -
        • -
      • - (C) point polygon::get_any_point_effectively_inside(); -
        • -
      -

      - There are different approaches to the issue of not having a value to return. -

      -

      - A typical approach is to consider the existence of a valid return value as - a postcondition, so that if the function cannot compute the value to return, - it has either undefined behavior (and can use assert in a debug build) or - uses a runtime check and throws an exception if the postcondition is violated. - This is a reasonable choice for example, for function (A), because the lack - of a proper return value is directly related to an invalid parameter (out - of domain argument), so it is appropriate to require the callee to supply - only parameters in a valid domain for execution to continue normally. -

      -

      - However, function (B), because of its asynchronous nature, does not fail - just because it can't find a value to return; so it is incorrect to consider - such a situation an error and assert or throw an exception. This function - must return, and somehow, must tell the callee that it is not returning a - meaningful value. -

      -

      - A similar situation occurs with function (C): it is conceptually an error - to ask a null-area polygon to return a point inside - itself, but in many applications, it is just impractical for performance - reasons to treat this as an error (because detecting that the polygon has - no area might be too expensive to be required to be tested previously), and - either an arbitrary point (typically at infinity) is returned, or some efficient - way to tell the callee that there is no such point is used. -

      -

      - There are various mechanisms to let functions communicate that the returned - value is not valid. One such mechanism, which is quite common since it has - zero or negligible overhead, is to use a special value which is reserved - to communicate this. Classical examples of such special values are EOF, string::npos, - points at infinity, etc... -

      -

      - When those values exist, i.e. the return type can hold all meaningful values - plus the signal value, this mechanism - is quite appropriate and well known. Unfortunately, there are cases when - such values do not exist. In these cases, the usual alternative is either - to use a wider type, such as int - in place of char; or a compound - type, such as std::pair<point,bool>. -

      -

      - Returning a std::pair<T,bool>, thus attaching a boolean flag to the - result which indicates if the result is meaningful, has the advantage that - can be turned into a consistent idiom since the first element of the pair - can be whatever the function would conceptually return. For example, the - last two functions could have the following interface: -

      -
      std::pair<char,bool> get_async_input();
-std::pair<point,bool> polygon::get_any_point_effectively_inside();
-
      -

      - These functions use a consistent interface for dealing with possibly nonexistent - results: -

      -
      std::pair<point,bool> p = poly.get_any_point_effectively_inside();
-if ( p.second )
-    flood_fill(p.first);
-
      -

      - However, not only is this quite a burden syntactically, it is also error - prone since the user can easily use the function result (first element of - the pair) without ever checking if it has a valid value. -

      -

      - Clearly, we need a better idiom. -

      -
      -
      -
      -
      -
      The - models
      -
      The - semantics
      -
      The - Interface
      -
      -
      -
      -

      - In C++, we can declare an object (a variable) of type - T, and we can give this - variable an initial value (through an initializer. - (cf. 8.5)). When a declaration includes a non-empty initializer (an initial - value is given), it is said that the object has been initialized. If the - declaration uses an empty initializer (no initial value is given), and - neither default nor value initialization applies, it is said that the object - is uninitialized. Its actual value exist - but has an indeterminate initial value (cf. 8.5/11). - optional<T> - intends to formalize the notion of initialization (or lack of it) allowing - a program to test whether an object has been initialized and stating that - access to the value of an uninitialized object is undefined behavior. That - is, when a variable is declared as optional<T> and no initial value is given, the - variable is formally uninitialized. A formally uninitialized - optional object has conceptually no value at all and this situation can - be tested at runtime. It is formally undefined behavior - to try to access the value of an uninitialized optional. An uninitialized - optional can be assigned a value, in which case its initialization state - changes to initialized. Furthermore, given the formal treatment of initialization - states in optional objects, it is even possible to reset an optional to - uninitialized. -

      -

      - In C++ there is no formal notion of uninitialized objects, which means - that objects always have an initial value even if indeterminate. As discussed - on the previous section, this has a drawback because you need additional - information to tell if an object has been effectively initialized. One - of the typical ways in which this has been historically dealt with is via - a special value: EOF, - npos, -1, etc... This is - equivalent to adding the special value to the set of possible values of - a given type. This super set of T - plus some nil_t—where nil_t - is some stateless POD—can be modeled in modern languages as a discriminated union of T and nil_t. Discriminated - unions are often called variants. A variant has a - current type, which in our case is either T or nil_t. - Using the Boost.Variant - library, this model can be implemented in terms of boost::variant<T,nil_t>. There is precedent for a discriminated - union as a model for an optional value: the Haskell - Maybe built-in type constructor. Thus, - a discriminated union T+nil_t - serves as a conceptual foundation. -

      -

      - A variant<T,nil_t> follows naturally from the traditional - idiom of extending the range of possible values adding an additional sentinel - value with the special meaning of Nothing. However, - this additional Nothing value is largely irrelevant - for our purpose since our goal is to formalize the notion of uninitialized - objects and, while a special extended value can be used to convey that - meaning, it is not strictly necessary in order to do so. -

      -

      - The observation made in the last paragraph about the irrelevant nature - of the additional nil_t - with respect to purpose of optional<T> - suggests an alternative model: a container that either - has a value of T or nothing. -

      -

      - As of this writing I don't know of any precedent for a variable-size fixed-capacity - (of 1) stack-based container model for optional values, yet I believe this - is the consequence of the lack of practical implementations of such a container - rather than an inherent shortcoming of the container model. -

      -

      - In any event, both the discriminated-union or the single-element container - models serve as a conceptual ground for a class representing optional—i.e. - possibly uninitialized—objects. For instance, these models show the - exact semantics required for a wrapper of optional - values: -

      -

      - Discriminated-union: -

      -
        -
      • - deep-copy semantics: copies of the - variant implies copies of the value. -
        • -
      • - deep-relational semantics: comparisons - between variants matches both current types and values -
        • -
      • - If the variant's current type is T, - it is modeling an initialized optional. -
        • -
      • - If the variant's current type is not T, - it is modeling an uninitialized optional. -
        • -
      • - Testing if the variant's current type is T - models testing if the optional is initialized -
        • -
      • - Trying to extract a T - from a variant when its current type is not T, - models the undefined behavior of trying to access the value of an uninitialized - optional -
        • -
      -

      - Single-element container: -

      -
        -
      • - deep-copy semantics: copies of the - container implies copies of the value. -
        • -
      • - deep-relational semantics: comparisons - between containers compare container size and if match, contained value -
        • -
      • - If the container is not empty (contains an object of type T), it is modeling an initialized - optional. -
        • -
      • - If the container is empty, it is modeling an uninitialized - optional. -
        • -
      • - Testing if the container is empty models testing if the optional is - initialized -
        • -
      • - Trying to extract a T - from an empty container models the undefined behavior of trying to - access the value of an uninitialized optional -
        • -
      -
      -
      -
      -

      - Objects of type optional<T> are intended to be used in places where - objects of type T would - but which might be uninitialized. Hence, optional<T>'s purpose is to formalize the additional - possibly uninitialized state. From the perspective of this role, optional<T> - can have the same operational semantics of T - plus the additional semantics corresponding to this special state. As such, - optional<T> - could be thought of as a supertype of T. Of course, we can't do that in C++, - so we need to compose the desired semantics using a different mechanism. - Doing it the other way around, that is, making optional<T> a subtype of - T is not only conceptually - wrong but also impractical: it is not allowed to derive from a non-class - type, such as a built-in type. -

      -

      - We can draw from the purpose of optional<T> the required basic semantics: -

      -
        -
      • - Default Construction: To introduce - a formally uninitialized wrapped object. -
        • -
      • - Direct Value Construction via copy: - To introduce a formally initialized wrapped object whose value is obtained - as a copy of some object. -
        • -
      • - Deep Copy Construction: To obtain - a new yet equivalent wrapped object. -
        • -
      • - Direct Value Assignment (upon initialized): - To assign a value to the wrapped object. -
        • -
      • - Direct Value Assignment (upon uninitialized): - To initialize the wrapped object with a value obtained as a copy of - some object. -
        • -
      • - Assignment (upon initialized): To - assign to the wrapped object the value of another wrapped object. -
        • -
      • - Assignment (upon uninitialized): To - initialize the wrapped object with value of another wrapped object. -
        • -
      • - Deep Relational Operations (when supported by - the type T): To compare wrapped object values taking into - account the presence of uninitialized states. -
        • -
      • - Value access: To unwrap the wrapped - object. -
        • -
      • - Initialization state query: To determine - if the object is formally initialized or not. -
        • -
      • - Swap: To exchange wrapped objects. - (with whatever exception safety guarantees are provided by T's swap). -
        • -
      • - De-initialization: To release the - wrapped object (if any) and leave the wrapper in the uninitialized - state. -
        • -
      -

      - Additional operations are useful, such as converting constructors and converting - assignments, in-place construction and assignment, and safe value access - via a pointer to the wrapped object or null. -

      -
      -
      -
      -

      - Since the purpose of optional is to allow us to use objects with a formal - uninitialized additional state, the interface could try to follow the interface - of the underlying T type - as much as possible. In order to choose the proper degree of adoption of - the native T interface, - the following must be noted: Even if all the operations supported by an - instance of type T are - defined for the entire range of values for such a type, an optional<T> - extends such a set of values with a new value for which most (otherwise - valid) operations are not defined in terms of T. -

      -

      - Furthermore, since optional<T> itself is merely a T - wrapper (modeling a T supertype), - any attempt to define such operations upon uninitialized optionals will - be totally artificial w.r.t. T. -

      -

      - This library chooses an interface which follows from T's - interface only for those operations which are well defined (w.r.t the type - T) even if any of the operands - are uninitialized. These operations include: construction, copy-construction, - assignment, swap and relational operations. -

      -

      - For the value access operations, which are undefined (w.r.t the type T) when the operand is uninitialized, - a different interface is chosen (which will be explained next). -

      -

      - Also, the presence of the possibly uninitialized state requires additional - operations not provided by T - itself which are supported by a special interface. -

      -
      - - Lexically-hinted - Value Access in the presence of possibly uninitialized optional objects: - The operators * and -> -
      -

      - A relevant feature of a pointer is that it can have a null - pointer value. This is a special value - which is used to indicate that the pointer is not referring to any object - at all. In other words, null pointer values convey the notion of nonexistent - objects. -

      -

      - This meaning of the null pointer value allowed pointers to became a de - facto standard for handling optional objects because all you - have to do to refer to a value which you don't really have is to use a - null pointer value of the appropriate type. Pointers have been used for - decades—from the days of C APIs to modern C++ libraries—to refer - to optional (that is, possibly nonexistent) objects; particularly as optional - arguments to a function, but also quite often as optional data members. -

      -

      - The possible presence of a null pointer value makes the operations that - access the pointee's value possibly undefined, therefore, expressions which - use dereference and access operators, such as: ( - *p - = 2 ) and ( - p->foo() ), implicitly convey the notion of optionality, - and this information is tied to the syntax of the - expressions. That is, the presence of operators * - and -> tell by themselves - —without any additional context— that the expression will be undefined - unless the implied pointee actually exist. -

      -

      - Such a de facto idiom for referring to optional objects - can be formalized in the form of a concept: the OptionalPointee - concept. This concept captures the syntactic usage of operators *, -> - and contextual conversion to bool - to convey the notion of optionality. -

      -

      - However, pointers are good to refer - to optional objects, but not particularly good to handle the optional objects - in all other respects, such as initializing or moving/copying them. The - problem resides in the shallow-copy of pointer semantics: if you need to - effectively move or copy the object, pointers alone are not enough. The - problem is that copies of pointers do not imply copies of pointees. For - example, as was discussed in the motivation, pointers alone cannot be used - to return optional objects from a function because the object must move - outside from the function and into the caller's context. -

      -

      - A solution to the shallow-copy problem that is often used is to resort - to dynamic allocation and use a smart pointer to automatically handle the - details of this. For example, if a function is to optionally return an - object X, it can use shared_ptr<X> - as the return value. However, this requires dynamic allocation of X. If X - is a built-in or small POD, this technique is very poor in terms of required - resources. Optional objects are essentially values so it is very convenient - to be able to use automatic storage and deep-copy semantics to manipulate - optional values just as we do with ordinary values. Pointers do not have - this semantics, so are inappropriate for the initialization and transport - of optional values, yet are quite convenient for handling the access to - the possible undefined value because of the idiomatic aid present in the - OptionalPointee - concept incarnated by pointers. -

      -
      - - Optional<T> - as a model of OptionalPointee -
      -

      - For value access operations optional<> uses operators * - and -> to lexically warn - about the possibly uninitialized state appealing to the familiar pointer - semantics w.r.t. to null pointers. -

      -
      - - - - - -
      [Warning]Warning

      - However, it is particularly important to note that optional<> objects are not pointers. optional<> is not, and does not model, a - pointer. -

      -

      - For instance, optional<> does not have shallow-copy so does - not alias: two different optionals never refer to the same - value unless T itself is - a reference (but may have equivalent values). The - difference between an optional<T> and a pointer must be kept in mind, - particularly because the semantics of relational operators are different: - since optional<T> - is a value-wrapper, relational operators are deep: they compare optional - values; but relational operators for pointers are shallow: they do not - compare pointee values. As a result, you might be able to replace optional<T> - by T* - on some situations but not always. Specifically, on generic code written - for both, you cannot use relational operators directly, and must use the - template functions equal_pointees() - and less_pointees() - instead. -

      -
      -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/a_note_about_optional_bool_.html b/doc/html/boost_optional/tutorial/a_note_about_optional_bool_.html deleted file mode 100644 index ffd5c3dc..00000000 --- a/doc/html/boost_optional/tutorial/a_note_about_optional_bool_.html +++ /dev/null @@ -1,108 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - optional<bool> should - be used with special caution and consideration. -

      -

      - First, it is functionally similar to a tristate boolean (false, maybe, true) - —such as boost::tribool— - except that in a tristate boolean, the maybe state represents - a valid value, unlike the corresponding state of an uninitialized - optional<bool>. - It should be carefully considered if an optional<bool> - instead of a tribool is really - needed. -

      -

      - Second, although optional<> provides a contextual conversion - to bool in C++11, this falls - back to an implicit conversion on older compilers. This conversion refers - to the initialization state and not to the contained value. Using optional<bool> can - lead to subtle errors due to the implicit bool - conversion: -

      -
      void foo ( bool v ) ;
-void bar()
-{
-    optional<bool> v = try();
-
-    // The following intended to pass the value of 'v' to foo():
-    foo(v);
-    // But instead, the initialization state is passed
-    // due to a typo: it should have been foo(*v).
-}
-
      -

      - The only implicit conversion is to bool, - and it is safe in the sense that typical integral promotions don't apply - (i.e. if foo() - takes an int instead, it won't - compile). -

      -

      - Third, mixed comparisons with bool - work differently than similar mixed comparisons between pointers and bool, so the results might surprise you: -

      -
      optional<bool> oEmpty(none), oTrue(true), oFalse(false);
-
-if (oEmpty == none);  // renders true
-if (oEmpty == false); // renders false!
-if (oEmpty == true);  // renders false!
-
-if (oFalse == none);  // renders false
-if (oFalse == false); // renders true!
-if (oFalse == true);  // renders false
-
-if (oTrue == none);   // renders false
-if (oTrue == false);  // renders false
-if (oTrue == true);   // renders true
-
      -

      - In other words, for optional<>, the following assertion does not - hold: -

      -
      assert((opt == false) == (!opt));
-
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2016 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/design_overview.html b/doc/html/boost_optional/tutorial/design_overview.html deleted file mode 100644 index c467658c..00000000 --- a/doc/html/boost_optional/tutorial/design_overview.html +++ /dev/null @@ -1,184 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      -
      -

      - In C++, we can declare an object (a variable) of type - T, and we can give this - variable an initial value (through an initializer. - (cf. 8.5)). When a declaration includes a non-empty initializer (an initial - value is given), it is said that the object has been initialized. If the - declaration uses an empty initializer (no initial value is given), and - neither default nor value initialization applies, it is said that the object - is uninitialized. Its actual value exist - but has an indeterminate initial value (cf. 8.5/11). - optional<T> - intends to formalize the notion of initialization (or lack of it) allowing - a program to test whether an object has been initialized and stating that - access to the value of an uninitialized object is undefined behavior. That - is, when a variable is declared as optional<T> and no initial value is given, the - variable is formally uninitialized. A formally uninitialized - optional object has conceptually no value at all and this situation can - be tested at runtime. It is formally undefined behavior - to try to access the value of an uninitialized optional. An uninitialized - optional can be assigned a value, in which case its initialization state - changes to initialized. Furthermore, given the formal treatment of initialization - states in optional objects, it is even possible to reset an optional to - uninitialized. -

      -

      - In C++ there is no formal notion of uninitialized objects, which means - that objects always have an initial value even if indeterminate. As discussed - on the previous section, this has a drawback because you need additional - information to tell if an object has been effectively initialized. One - of the typical ways in which this has been historically dealt with is via - a special value: EOF, - npos, -1, etc... This is - equivalent to adding the special value to the set of possible values of - a given type. This super set of T - plus some nil_t—where nil_t - is some stateless POD—can be modeled in modern languages as a discriminated union of T and nil_t. Discriminated - unions are often called variants. A variant has a - current type, which in our case is either T or nil_t. - Using the Boost.Variant - library, this model can be implemented in terms of boost::variant<T,nil_t>. There is precedent for a discriminated - union as a model for an optional value: the Haskell - Maybe built-in type constructor. Thus, - a discriminated union T+nil_t - serves as a conceptual foundation. -

      -

      - A variant<T,nil_t> follows naturally from the traditional - idiom of extending the range of possible values adding an additional sentinel - value with the special meaning of Nothing. However, - this additional Nothing value is largely irrelevant - for our purpose since our goal is to formalize the notion of uninitialized - objects and, while a special extended value can be used to convey that - meaning, it is not strictly necessary in order to do so. -

      -

      - The observation made in the last paragraph about the irrelevant nature - of the additional nil_t - with respect to purpose of optional<T> - suggests an alternative model: a container that either - has a value of T or nothing. -

      -

      - As of this writing I don't know of any precedent for a variable-size fixed-capacity - (of 1) stack-based container model for optional values, yet I believe this - is the consequence of the lack of practical implementations of such a container - rather than an inherent shortcoming of the container model. -

      -

      - In any event, both the discriminated-union or the single-element container - models serve as a conceptual ground for a class representing optional—i.e. - possibly uninitialized—objects. For instance, these models show the - exact semantics required for a wrapper of optional - values: -

      -

      - Discriminated-union: -

      -
        -
      • - deep-copy semantics: copies of the - variant implies copies of the value. -
        • -
      • - deep-relational semantics: comparisons - between variants matches both current types and values -
        • -
      • - If the variant's current type is T, - it is modeling an initialized optional. -
        • -
      • - If the variant's current type is not T, - it is modeling an uninitialized optional. -
        • -
      • - Testing if the variant's current type is T - models testing if the optional is initialized -
        • -
      • - Trying to extract a T - from a variant when its current type is not T, - models the undefined behavior of trying to access the value of an uninitialized - optional -
        • -
      -

      - Single-element container: -

      -
        -
      • - deep-copy semantics: copies of the - container implies copies of the value. -
        • -
      • - deep-relational semantics: comparisons - between containers compare container size and if match, contained value -
        • -
      • - If the container is not empty (contains an object of type T), it is modeling an initialized - optional. -
        • -
      • - If the container is empty, it is modeling an uninitialized - optional. -
        • -
      • - Testing if the container is empty models testing if the optional is - initialized -
        • -
      • - Trying to extract a T - from an empty container models the undefined behavior of trying to - access the value of an uninitialized optional -
        • -
      -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/design_overview/the_interface.html b/doc/html/boost_optional/tutorial/design_overview/the_interface.html deleted file mode 100644 index f0bbc860..00000000 --- a/doc/html/boost_optional/tutorial/design_overview/the_interface.html +++ /dev/null @@ -1,187 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Since the purpose of optional is to allow us to use objects with a formal - uninitialized additional state, the interface could try to follow the interface - of the underlying T type - as much as possible. In order to choose the proper degree of adoption of - the native T interface, - the following must be noted: Even if all the operations supported by an - instance of type T are - defined for the entire range of values for such a type, an optional<T> - extends such a set of values with a new value for which most (otherwise - valid) operations are not defined in terms of T. -

      -

      - Furthermore, since optional<T> itself is merely a T - wrapper (modeling a T supertype), - any attempt to define such operations upon uninitialized optionals will - be totally artificial w.r.t. T. -

      -

      - This library chooses an interface which follows from T's - interface only for those operations which are well defined (w.r.t the type - T) even if any of the operands - are uninitialized. These operations include: construction, copy-construction, - assignment, swap and relational operations. -

      -

      - For the value access operations, which are undefined (w.r.t the type T) when the operand is uninitialized, - a different interface is chosen (which will be explained next). -

      -

      - Also, the presence of the possibly uninitialized state requires additional - operations not provided by T - itself which are supported by a special interface. -

      -
      - - Lexically-hinted - Value Access in the presence of possibly uninitialized optional objects: - The operators * and -> -
      -

      - A relevant feature of a pointer is that it can have a null - pointer value. This is a special value - which is used to indicate that the pointer is not referring to any object - at all. In other words, null pointer values convey the notion of nonexistent - objects. -

      -

      - This meaning of the null pointer value allowed pointers to became a de - facto standard for handling optional objects because all you - have to do to refer to a value which you don't really have is to use a - null pointer value of the appropriate type. Pointers have been used for - decades—from the days of C APIs to modern C++ libraries—to refer - to optional (that is, possibly nonexistent) objects; particularly as optional - arguments to a function, but also quite often as optional data members. -

      -

      - The possible presence of a null pointer value makes the operations that - access the pointee's value possibly undefined, therefore, expressions which - use dereference and access operators, such as: ( - *p - = 2 ) and ( - p->foo() ), implicitly convey the notion of optionality, - and this information is tied to the syntax of the - expressions. That is, the presence of operators * - and -> tell by themselves - —without any additional context— that the expression will be undefined - unless the implied pointee actually exist. -

      -

      - Such a de facto idiom for referring to optional objects - can be formalized in the form of a concept: the OptionalPointee concept. This - concept captures the syntactic usage of operators *, - -> and contextual conversion - to bool to convey the notion - of optionality. -

      -

      - However, pointers are good to refer - to optional objects, but not particularly good to handle the optional objects - in all other respects, such as initializing or moving/copying them. The - problem resides in the shallow-copy of pointer semantics: if you need to - effectively move or copy the object, pointers alone are not enough. The - problem is that copies of pointers do not imply copies of pointees. For - example, as was discussed in the motivation, pointers alone cannot be used - to return optional objects from a function because the object must move - outside from the function and into the caller's context. -

      -

      - A solution to the shallow-copy problem that is often used is to resort - to dynamic allocation and use a smart pointer to automatically handle the - details of this. For example, if a function is to optionally return an - object X, it can use shared_ptr<X> - as the return value. However, this requires dynamic allocation of X. If X - is a built-in or small POD, this technique is very poor in terms of required - resources. Optional objects are essentially values so it is very convenient - to be able to use automatic storage and deep-copy semantics to manipulate - optional values just as we do with ordinary values. Pointers do not have - this semantics, so are inappropriate for the initialization and transport - of optional values, yet are quite convenient for handling the access to - the possible undefined value because of the idiomatic aid present in the - OptionalPointee - concept incarnated by pointers. -

      -
      - - Optional<T> - as a model of OptionalPointee -
      -

      - For value access operations optional<> uses operators * - and -> to lexically warn - about the possibly uninitialized state appealing to the familiar pointer - semantics w.r.t. to null pointers. -

      -
      - - - - - -
      [Caution]Caution

      - However, it is particularly important to note that optional<> objects are not pointers. optional<> is not, and does not model, a - pointer. -

      -

      - For instance, optional<> does not have shallow-copy so does - not alias: two different optionals never refer to the same - value unless T itself is - a reference (but may have equivalent values). The - difference between an optional<T> and a pointer must be kept in mind, - particularly because the semantics of relational operators are different: - since optional<T> - is a value-wrapper, relational operators are deep: they compare optional - values; but relational operators for pointers are shallow: they do not - compare pointee values. As a result, you might be able to replace optional<T> - by T* - on some situations but not always. Specifically, on generic code written - for both, you cannot use relational operators directly, and must use the - template functions equal_pointees() - and less_pointees() - instead. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/design_overview/the_semantics.html b/doc/html/boost_optional/tutorial/design_overview/the_semantics.html deleted file mode 100644 index 58e52267..00000000 --- a/doc/html/boost_optional/tutorial/design_overview/the_semantics.html +++ /dev/null @@ -1,121 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Objects of type optional<T> are intended to be used in places where - objects of type T would - but which might be uninitialized. Hence, optional<T>'s purpose is to formalize the additional - possibly uninitialized state. From the perspective of this role, optional<T> - can have the same operational semantics of T - plus the additional semantics corresponding to this special state. As such, - optional<T> - could be thought of as a supertype of T. Of course, we can't do that in C++, - so we need to compose the desired semantics using a different mechanism. - Doing it the other way around, that is, making optional<T> a subtype of - T is not only conceptually - wrong but also impractical: it is not allowed to derive from a non-class - type, such as a built-in type. -

      -

      - We can draw from the purpose of optional<T> the required basic semantics: -

      -
        -
      • - Default Construction: To introduce - a formally uninitialized wrapped object. -
        • -
      • - Direct Value Construction via copy: - To introduce a formally initialized wrapped object whose value is obtained - as a copy of some object. -
        • -
      • - Deep Copy Construction: To obtain - a new yet equivalent wrapped object. -
        • -
      • - Direct Value Assignment (upon initialized): - To assign a value to the wrapped object. -
        • -
      • - Direct Value Assignment (upon uninitialized): - To initialize the wrapped object with a value obtained as a copy of - some object. -
        • -
      • - Assignment (upon initialized): To - assign to the wrapped object the value of another wrapped object. -
        • -
      • - Assignment (upon uninitialized): To - initialize the wrapped object with value of another wrapped object. -
        • -
      • - Deep Relational Operations (when supported by - the type T): To compare wrapped object values taking into - account the presence of uninitialized states. -
        • -
      • - Value access: To unwrap the wrapped - object. -
        • -
      • - Initialization state query: To determine - if the object is formally initialized or not. -
        • -
      • - Swap: To exchange wrapped objects. - (with whatever exception safety guarantees are provided by T's swap). -
        • -
      • - De-initialization: To release the - wrapped object (if any) and leave the wrapper in the uninitialized - state. -
        • -
      -

      - Additional operations are useful, such as converting constructors and converting - assignments, in-place construction and assignment, and safe value access - via a pointer to the wrapped object or null. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/exception_safety_guarantees.html b/doc/html/boost_optional/tutorial/exception_safety_guarantees.html deleted file mode 100644 index 90d817cc..00000000 --- a/doc/html/boost_optional/tutorial/exception_safety_guarantees.html +++ /dev/null @@ -1,175 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - This library assumes that T's - destructor does not throw exceptions. If it does, the behaviour of many operations - on optional<T> is - undefined. -

      -

      - The following mutating operations never throw exceptions: -

      -
        -
      • - optional<T>::operator= ( none_t - ) noexcept -
        • -
      • - optional<T>::reset() noexcept -
        • -
      -

      - In addition, the following constructors and the destructor never throw exceptions: -

      -
        -
      • - optional<T>::optional() - noexcept -
        • -
      • - optional<T>::optional( - none_t ) - noexcept -
        • -
      -

      - Regarding the following assignment functions: -

      -
        -
      • - optional<T>::operator= ( optional<T> const& ) -
        • -
      • - optional<T>::operator= ( T const& ) -
        • -
      • - template<class U> optional<T>::operator= ( optional<U> const& ) -
        • -
      • - template<class InPlaceFactory> optional<T>::operator= ( InPlaceFactory - const& - ) -
        • -
      • - template<class TypedInPlaceFactory> optional<T>::operator= ( TypedInPlaceFactory - const& - ) -
        • -
      • - optional<T>::reset( T const& ) -
        • -
      -

      - They forward calls to the corresponding T's - constructors or assignments (depending on whether the optional object is - initialized or not); so if both T's - constructor and the assignment provide strong exception safety guarantee, - optional<T>'s - assignment also provides strong exception safety guarantee; otherwise we - only get the basic guarantee. Additionally, if both involved T's constructor and the assignment never - throw, optional<T>'s - assignment also never throws. -

      -

      - Unless T's constructor or - assignment throws, assignments to optional<T> - do not throw anything else on its own. A throw during assignment never changes - the initialization state of any optional object involved: -

      -
      optional<T> opt1(val1);
-optional<T> opt2(val2);
-assert(opt1);
-assert(opt2);
-
-try
-{
-  opt1 = opt2; // throws
-}
-catch(...)
-{
-  assert(opt1);
-  assert(opt2);
-}
-
      -

      - This also applies to move assignments/constructors. However, move operations - are made no-throw more often. -

      -

      - Operation emplace provides - basic exception safety guarantee. If it throws, the optional object becomes - uninitialized regardless of its initial state, and its previous contained - value (if any) is destroyed. It doesn't call any assignment or move/copy - constructor on T. -

      -
      - - Swap -
      -

      - Unless swap on optional is - customized, its primary implementation forwards calls to T's - swap or move constructor - (depending on the initialization state of the optional objects). Thus, if - both T's swap - and move constructor never throw, swap - on optional<T> never - throws. similarly, if both T's - swap and move constructor - offer strong guarantee, swap - on optional<T> also - offers a strong guarantee. -

      -

      - In case swap on optional - is customized, the call to T's - move constructor are replaced with the calls to T's - default constructor followed by swap. - (This is more useful on older compilers that do not support move semantics, - when one wants to achieve stronger exception safety guarantees.) In this - case the exception safety guarantees for swap - are reliant on the guarantees of T's - swap and default constructor -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/gotchas.html b/doc/html/boost_optional/tutorial/gotchas.html deleted file mode 100644 index 9382442d..00000000 --- a/doc/html/boost_optional/tutorial/gotchas.html +++ /dev/null @@ -1,112 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      -
      -

      - optional<bool> - should be used with special caution and consideration. -

      -

      - First, it is functionally similar to a tristate boolean (false, maybe, - true) —such as boost::tribool— - except that in a tristate boolean, the maybe state represents - a valid value, unlike the corresponding state of an uninitialized - optional<bool>. - It should be carefully considered if an optional<bool> instead of a tribool - is really needed. -

      -

      - Second, although optional<> provides a contextual conversion - to bool in C++11, this falls - back to an implicit conversion on older compilers. This conversion refers - to the initialization state and not to the contained value. Using optional<bool> - can lead to subtle errors due to the implicit bool - conversion: -

      -
      void foo ( bool v ) ;
-void bar()
-{
-    optional<bool> v = try();
-
-    // The following intended to pass the value of 'v' to foo():
-    foo(v);
-    // But instead, the initialization state is passed
-    // due to a typo: it should have been foo(*v).
-}
-
      -

      - The only implicit conversion is to bool, - and it is safe in the sense that typical integral promotions don't apply - (i.e. if foo() - takes an int instead, it won't - compile). -

      -

      - Third, mixed comparisons with bool - work differently than similar mixed comparisons between pointers and bool, so the results might surprise you: -

      -
      optional<bool> oEmpty(none), oTrue(true), oFalse(false);
-
-if (oEmpty == none);  // renders true
-if (oEmpty == false); // renders false!
-if (oEmpty == true);  // renders false!
-
-if (oFalse == none);  // renders false
-if (oFalse == false); // renders true!
-if (oFalse == true);  // renders false
-
-if (oTrue == none);   // renders false
-if (oTrue == false);  // renders false
-if (oTrue == true);   // renders true
-
      -

      - In other words, for optional<>, the following assertion does not - hold: -

      -
      assert((opt == false) == (!opt));
-
      -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html b/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html deleted file mode 100644 index 0228f2ea..00000000 --- a/doc/html/boost_optional/tutorial/gotchas/false_positive_with__wmaybe_uninitialized.html +++ /dev/null @@ -1,77 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Sometimes on GCC compilers below version 5.1 you may get an -Wmaybe-uninitialized - warning when compiling with option -02 on a perfectly valid boost::optional usage. For instance in this - program: -

      -
      #include <boost/optional.hpp>
-
-boost::optional<int> getitem();
-
-int main(int argc, const char *[])
-{
-  boost::optional<int> a = getitem();
-  boost::optional<int> b;
-
-  if (argc > 0)
-    b = argc;
-
-  if (a != b)
-    return 1;
-
-  return 0;
-}
-
      -

      - This is a bug in the compiler. As a workaround (provided in this - Stack Overflow question) use the following way of initializing - an optional containing no value: -

      -
      boost::optional<int> b = boost::make_optional(false, int());
-
      -

      - This is obviously redundant, but makes the warning disappear. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html b/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html deleted file mode 100644 index c89f67d9..00000000 --- a/doc/html/boost_optional/tutorial/gotchas/mixed_relational_comparisons.html +++ /dev/null @@ -1,59 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Because T is convertible - to optional<T> - and because optional<T> - is LessThanComparable when T is LessThanComparable, you can sometimes - get an unexpected runtime result where you would rather expect a compiler - error: -

      -
      optional<double> Flight_plan::weight(); // sometimes no weight can be returned
-
-bool is_aircraft_too_heavy(Flight_plan const& p)
-{
-   return p.weight() > p.aircraft().max_weight(); // compiles!
-}                                                 // returns false when the optional contains no value 
-
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html b/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html deleted file mode 100644 index 7924e618..00000000 --- a/doc/html/boost_optional/tutorial/gotchas/moved_from__optional_.html +++ /dev/null @@ -1,63 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - When an optional object that contains a value is moved from (is a source - of move constructor or assignment) it still contains a value and its contained - value is left in a moved-from state. This can be illustrated with the following - example. -

      -
      optional<std::unique_ptr<int>> opi {std::make_unique<int>(1)};
-optional<std::unique_ptr<int>> opj = std::move(opi);
-assert (opi);
-assert (*opi == nullptr);
-
      -

      - Quite a lot of people expect that when an object that contains a value - is moved from, its contained value should be destroyed. This is not so, - for performance reasons. Current semantics allow the implementation of - boost::optional<T> - to be trivially copyable when T - is trivial. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/in_place_factories.html b/doc/html/boost_optional/tutorial/in_place_factories.html deleted file mode 100644 index 10e62baa..00000000 --- a/doc/html/boost_optional/tutorial/in_place_factories.html +++ /dev/null @@ -1,197 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - One of the typical problems with wrappers and containers is that their interfaces - usually provide an operation to initialize or assign the contained object - as a copy of some other object. This not only requires the underlying type - to be CopyConstructible, but also requires - the existence of a fully constructed object, often temporary, just to follow - the copy from: -

      -
      struct X
-{
-    X ( int, std::string ) ;
-} ;
-
-class W
-{
-    X wrapped_ ;
-
-    public:
-
-    W ( X const& x ) : wrapped_(x) {}
-} ;
-
-void foo()
-{
-    // Temporary object created.
-    W ( X(123,"hello") ) ;
-}
-
      -

      - A solution to this problem is to support direct construction of the contained - object right in the container's storage. In this scheme, the user only needs - to supply the arguments to the constructor to use in the wrapped object construction. -

      -
      class W
-{
-    X wrapped_ ;
-
-    public:
-
-    W ( X const& x ) : wrapped_(x) {}
-    W ( int a0, std::string a1) : wrapped_(a0,a1) {}
-} ;
-
-void foo()
-{
-    // Wrapped object constructed in-place
-    // No temporary created.
-    W (123,"hello") ;
-}
-
      -

      - A limitation of this method is that it doesn't scale well to wrapped objects - with multiple constructors nor to generic code were the constructor overloads - are unknown. -

      -

      - The solution presented in this library is the family of InPlaceFactories - and TypedInPlaceFactories. These factories - are a family of classes which encapsulate an increasing number of arbitrary - constructor parameters and supply a method to construct an object of a given - type using those parameters at an address specified by the user via placement - new. -

      -

      - For example, one member of this family looks like: -

      -
      template<class T,class A0, class A1>
-class TypedInPlaceFactory2
-{
-    A0 m_a0 ; A1 m_a1 ;
-
-    public:
-
-    TypedInPlaceFactory2( A0 const& a0, A1 const& a1 ) : m_a0(a0), m_a1(a1) {}
-
-    void construct ( void* p ) { new (p) T(m_a0,m_a1) ; }
- } ;
-
      -

      - A wrapper class aware of this can use it as: -

      -
      class W
-{
-    X wrapped_ ;
-
-    public:
-
-    W ( X const& x ) : wrapped_(x) {}
-    W ( TypedInPlaceFactory2 const& fac ) { fac.construct(&wrapped_) ; }
-} ;
-
-void foo()
-{
-    // Wrapped object constructed in-place via a TypedInPlaceFactory.
-    // No temporary created.
-    W ( TypedInPlaceFactory2<X,int,std::string>(123,"hello")) ;
-}
-
      -

      - The factories are divided in two groups: -

      -
        -
      • - TypedInPlaceFactories: those which - take the target type as a primary template parameter. -
        • -
      • - InPlaceFactories: those with a - template construct(void*) - member function taking the target type. -
        • -
      -

      - Within each group, all the family members differ only in the number of parameters - allowed. -

      -

      - This library provides an overloaded set of helper template functions to construct - these factories without requiring unnecessary template parameters: -

      -
      template<class A0,...,class AN>
-InPlaceFactoryN <A0,...,AN> in_place ( A0 const& a0, ..., AN const& aN) ;
-
-template<class T,class A0,...,class AN>
-TypedInPlaceFactoryN <T,A0,...,AN> in_place ( T const& a0, A0 const& a0, ..., AN const& aN) ;
-
      -

      - In-place factories can be used generically by the wrapper and user as follows: -

      -
      class W
-{
-    X wrapped_ ;
-
-    public:
-
-    W ( X const& x ) : wrapped_(x) {}
-
-    template< class InPlaceFactory >
-    W ( InPlaceFactory const& fac ) { fac.template <X>construct(&wrapped_) ; }
-
-} ;
-
-void foo()
-{
-    // Wrapped object constructed in-place via a InPlaceFactory.
-    // No temporary created.
-    W ( in_place(123,"hello") ) ;
-}
-
      -

      - The factories are implemented in the headers: in_place_factory.hpp - and typed_in_place_factory.hpp -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/io_operators.html b/doc/html/boost_optional/tutorial/io_operators.html deleted file mode 100644 index d6d9dcbd..00000000 --- a/doc/html/boost_optional/tutorial/io_operators.html +++ /dev/null @@ -1,87 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - It is possible to use optional<T> - with IO streams, provided that T - can be used with streams. IOStream operators are defined in a separate header. -

      -

      -

      -
      #include <iostream>
-#include <boost/optional/optional_io.hpp>
-
-int main()
-{
-  boost::optional<int> o1 = 1, oN = boost::none;
-  std::cout << o1;
-  std::cin >> oN;
-}
-
      -

      -

      -

      - The current implementation does not guarantee any particular output. What - it guarantees is that if streaming out and then back in T - gives the same value, then streaming out and then back in optional<T> - will also give back the same result: -

      -

      -

      -
      #include <cassert>
-#include <sstream>
-#include <boost/optional/optional_io.hpp>
-
-int main()
-{
-  boost::optional<int> o1 = 1, oN = boost::none;
-  boost::optional<int> x1, x2;
-  std::stringstream s;
-  s << o1 << oN;
-  s >> x1 >> x2;
-  assert (o1 == x1);
-  assert (oN == x2);
-}
-
      -

      -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/motivation.html b/doc/html/boost_optional/tutorial/motivation.html deleted file mode 100644 index 3b9f43cf..00000000 --- a/doc/html/boost_optional/tutorial/motivation.html +++ /dev/null @@ -1,129 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Consider these functions which should return a value but which might not - have a value to return: -

      -
        -
      • - (A) double sqrt(double n ); -
        • -
      • - (B) char get_async_input(); -
        • -
      • - (C) point polygon::get_any_point_effectively_inside(); -
        • -
      -

      - There are different approaches to the issue of not having a value to return. -

      -

      - A typical approach is to consider the existence of a valid return value as - a postcondition, so that if the function cannot compute the value to return, - it has either undefined behavior (and can use assert in a debug build) or - uses a runtime check and throws an exception if the postcondition is violated. - This is a reasonable choice for example, for function (A), because the lack - of a proper return value is directly related to an invalid parameter (out - of domain argument), so it is appropriate to require the callee to supply - only parameters in a valid domain for execution to continue normally. -

      -

      - However, function (B), because of its asynchronous nature, does not fail - just because it can't find a value to return; so it is incorrect to consider - such a situation an error and assert or throw an exception. This function - must return, and somehow, must tell the callee that it is not returning a - meaningful value. -

      -

      - A similar situation occurs with function (C): it is conceptually an error - to ask a null-area polygon to return a point inside - itself, but in many applications, it is just impractical for performance - reasons to treat this as an error (because detecting that the polygon has - no area might be too expensive to be required to be tested previously), and - either an arbitrary point (typically at infinity) is returned, or some efficient - way to tell the callee that there is no such point is used. -

      -

      - There are various mechanisms to let functions communicate that the returned - value is not valid. One such mechanism, which is quite common since it has - zero or negligible overhead, is to use a special value which is reserved - to communicate this. Classical examples of such special values are EOF, string::npos, - points at infinity, etc... -

      -

      - When those values exist, i.e. the return type can hold all meaningful values - plus the signal value, this mechanism - is quite appropriate and well known. Unfortunately, there are cases when - such values do not exist. In these cases, the usual alternative is either - to use a wider type, such as int - in place of char; or a compound - type, such as std::pair<point,bool>. -

      -

      - Returning a std::pair<T,bool>, thus attaching a boolean flag to the - result which indicates if the result is meaningful, has the advantage that - can be turned into a consistent idiom since the first element of the pair - can be whatever the function would conceptually return. For example, the - last two functions could have the following interface: -

      -
      std::pair<char,bool> get_async_input();
-std::pair<point,bool> polygon::get_any_point_effectively_inside();
-
      -

      - These functions use a consistent interface for dealing with possibly nonexistent - results: -

      -
      std::pair<point,bool> p = poly.get_any_point_effectively_inside();
-if ( p.second )
-    flood_fill(p.first);
-
      -

      - However, not only is this quite a burden syntactically, it is also error - prone since the user can easily use the function result (first element of - the pair) without ever checking if it has a valid value. -

      -

      - Clearly, we need a better idiom. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/optional_references.html b/doc/html/boost_optional/tutorial/optional_references.html deleted file mode 100644 index ff16598d..00000000 --- a/doc/html/boost_optional/tutorial/optional_references.html +++ /dev/null @@ -1,117 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      -
      -

      - This library allows the template parameter T - to be of reference type: T&, and to some extent, T const&. -

      -

      - However, since references are not real objects some restrictions apply - and some operations are not available in this case: -

      -
        -
      • - Converting constructors -
        • -
      • - Converting assignment -
        • -
      • - InPlace construction -
        • -
      • - InPlace assignment -
        • -
      • - Value-access via pointer -
        • -
      -

      - Also, even though optional<T&> treats it wrapped pseudo-object - much as a real value, a true real reference is stored so aliasing will - occur: -

      -
        -
      • - Copies of optional<T&> will copy the references but - all these references will nonetheless refer to the same object. -
        • -
      • - Value-access will actually provide access to the referenced object - rather than the reference itself. -
        • -
      -
      - - - - - -
      [Caution]Caution

      - On compilers that do not conform to Standard C++ rules of reference binding, - some operations on optional references are disabled in order to prevent - subtle bugs. For more details see Dependencies - and Portability section. -

      -
      - - Rvalue - references -
      -

      - Rvalue references and lvalue references to const have the ability in C++ - to extend the life time of a temporary they bind to. Optional references - do not have this capability, therefore to avoid surprising effects it is - not possible to initialize an optional references from a temporary. Optional - rvalue references are disabled altogether. Also, the initialization and - assignment of an optional reference to const from rvalue reference is disabled. -

      -
      const int& i = 1;            // legal
-optional<const int&> oi = 1; // illegal
-
      -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html b/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html deleted file mode 100644 index 112eb5da..00000000 --- a/doc/html/boost_optional/tutorial/optional_references/rebinding_semantics_for_assignment_of_optional_references.html +++ /dev/null @@ -1,147 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - If you assign to an uninitialized optional<T&> the effect is to bind (for the - first time) to the object. Clearly, there is no other choice. -

      -
      int x = 1 ;
-int& rx = x ;
-optional<int&> ora ;
-optional<int&> orb(x) ;
-ora = orb ; // now 'ora' is bound to 'x' through 'rx'
-*ora = 2 ; // Changes value of 'x' through 'ora'
-assert(x==2);
-
      -

      - If you assign to a bare C++ reference, the assignment is forwarded to the - referenced object; its value changes but the reference is never rebound. -

      -
      int a = 1 ;
-int& ra = a ;
-int b = 2 ;
-int& rb = b ;
-ra = rb ; // Changes the value of 'a' to 'b'
-assert(a==b);
-b = 3 ;
-assert(ra!=b); // 'ra' is not rebound to 'b'
-
      -

      - Now, if you assign to an initialized optional<T&>, - the effect is to rebind to the new object - instead of assigning the referee. This is unlike bare C++ references. -

      -
      int a = 1 ;
-int b = 2 ;
-int& ra = a ;
-int& rb = b ;
-optional<int&> ora(ra) ;
-optional<int&> orb(rb) ;
-ora = orb ; // 'ora' is rebound to 'b'
-*ora = 3 ; // Changes value of 'b' (not 'a')
-assert(a==1);
-assert(b==3);
-
      -
      - - Rationale -
      -

      - Rebinding semantics for the assignment of initialized - optional references has - been chosen to provide consistency among initialization - states even at the expense of lack of consistency with the semantics - of bare C++ references. It is true that optional<U> strives to behave as much as possible - as U does whenever it is - initialized; but in the case when U - is T&, - doing so would result in inconsistent behavior w.r.t to the lvalue initialization - state. -

      -

      - Imagine optional<T&> - forwarding assignment to the referenced object (thus changing the referenced - object value but not rebinding), and consider the following code: -

      -
      optional<int&> a = get();
-int x = 1 ;
-int& rx = x ;
-optional<int&> b(rx);
-a = b ;
-
      -

      - What does the assignment do? -

      -

      - If a is uninitialized, - the answer is clear: it binds to x - (we now have another reference to x). - But what if a is already - initialized? it would change the value of the referenced - object (whatever that is); which is inconsistent with the other possible - case. -

      -

      - If optional<T&> - would assign just like T& does, you would never be able to use - Optional's assignment without explicitly handling the previous initialization - state unless your code is capable of functioning whether after the assignment, - a aliases the same object - as b or not. -

      -

      - That is, you would have to discriminate in order to be consistent. -

      -

      - If in your code rebinding to another object is not an option, then it is - very likely that binding for the first time isn't either. In such case, - assignment to an uninitialized optional<T&> shall be prohibited. It is quite - possible that in such a scenario it is a precondition that the lvalue must - be already initialized. If it isn't, then binding for the first time is - OK while rebinding is not which is IMO very unlikely. In such a scenario, - you can assign the value itself directly, as in: -

      -
      assert(!!opt);
-*opt=value;
-
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/performance_considerations.html b/doc/html/boost_optional/tutorial/performance_considerations.html deleted file mode 100644 index e20cf61a..00000000 --- a/doc/html/boost_optional/tutorial/performance_considerations.html +++ /dev/null @@ -1,265 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Technical details aside, the memory layout of optional<T> - for a generic T is more-less - this: -

      -
      template <typename T>
-class optional
-{
-  bool _initialized;
-  std::aligned_storage_t<sizeof(t), alignof(T)> _storage;
-};
-
      -

      - Lifetime of the T inside - _storage is manually controlled - with placement-news and pseudo-destructor - calls. However, for scalar Ts - we use a different way of storage, by simply holding a T: -

      -
      template <typename T>
-class optional
-{
-  bool _initialized;
-  T _storage;
-};
-
      -

      - We call it a direct storage. This makes optional<T> a - trivially-copyable type for scalar Ts. - This only works for compilers that support defaulted functions (including - defaulted move assignment and constructor). On compilers without defaulted - functions we still use the direct storage, but optional<T> - is no longer recognized as trivially-copyable. Apart from scalar types, we - leave the programmer a way of customizing her type, so that it is recognized - by optional as candidate - for optimized storage, by specializing type trait boost::optional_config::optional_uses_direct_storage_for: -

      -
      struct X // not trivial
-{
-  X() {}
-};
-
-namespace boost { namespace optional_config {
-
-  template <> struct optional_uses_direct_storage_for<X> : boost::true_type {};
-
-}}
-
      -
      - - Controlling - the size -
      -

      - For the purpose of the following analysis, considering memory layouts, we - can think of it as: -

      -
      template <typename T>
-class optional
-{
-  bool _initialized;
-  T _storage;
-};
-
      -

      - Given type optional<int>, and - assuming that sizeof(int) == - 4, we will get sizeof(optional<int>) - == 8. - This is so because of the alignment rules, for our two members we get the - following alignment: -

      -

      - opt_align1 -

      -

      - This means you can fit twice as many ints - as optional<int>s into - the same space of memory. Therefore, if the size of the objects is critical - for your application (e.g., because you want to utilize your CPU cache in - order to gain performance) and you have determined you are willing to trade - the code clarity, it is recommended that you simply go with type int and use some 'magic value' to represent - not-an-int, or use something like markable library. -

      -

      - Even if you cannot spare any value of int - to represent not-an-int (e.g., because every value is - useful, or you do want to signal not-an-int explicitly), - at least for Trivial types - you should consider storing the value and the bool - flag representing the null-state separately. Consider - the following class: -

      -
      struct Record
-{
-  optional<int> _min;
-  optional<int> _max;
-};
-
      -

      - Its memory layout can be depicted as follows: -

      -

      - opt_align2 -

      -

      - This is exactly the same as if we had the following members: -

      -
      struct Record
-{
-  bool _has_min;
-  int  _min;
-  bool _has_max;
-  int  _max;
-};
-
      -

      - But when they are stored separately, we at least have an option to reorder - them like this: -

      -
      struct Record
-{
-  bool _has_min;
-  bool _has_max;
-  int  _min;
-  int  _max;
-};
-
      -

      - Which gives us the following layout (and smaller total size): -

      -

      - opt_align3 -

      -

      - Sometimes it requires detailed consideration what data we make optional. - In our case above, if we determine that both minimum and maximum value can - be provided or not provided together, but one is never provided without the - other, we can make only one optional member: -

      -
      struct Limits
-{
-  int  _min;
-  int  _max;
-};
-
-struct Record
-{
-  optional<Limits> _limits;
-};
-
      -

      - This would give us the following layout: -

      -

      - opt_align4 -

      -
      - - Optional - function parameters -
      -

      - Having function parameters of type const - optional<T>& - may incur certain unexpected run-time cost connected to copy construction - of T. Consider the following - code. -

      -
      void fun(const optional<Big>& v)
-{
-  if (v) doSomethingWith(*v);
-  else   doSomethingElse();
-}
-
-int main()
-{
-  optional<Big> ov;
-  Big v;
-  fun(none);
-  fun(ov); // no copy
-  fun(v);  // copy constructor of Big
-}
-
      -

      - No copy elision or move semantics can save us from copying type Big here. Not that we need any copy, but - this is how optional works. - In order to avoid copying in this case, one could provide second overload - of fun: -

      -
      void fun(const Big& v)
-{
-  doSomethingWith(v);
-}
-
-int main()
-{
-  optional<Big> ov;
-  Big v;
-  fun(ov); // no copy
-  fun(v);  // no copy: second overload selected
-}
-
      -

      - Alternatively, you could consider using an optional reference instead: -

      -
      void fun(optional<const Big&> v) // note where the reference is
-{
-  if (v) doSomethingWith(*v);
-  else   doSomethingElse();
-}
-
-int main()
-{
-  optional<Big> ov;
-  Big v;
-  fun(none);
-  fun(ov); // doesn't compile
-  fun(v);  // no copy
-}
-
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/rebinding_semantics_for_assignment_of_optional_references.html b/doc/html/boost_optional/tutorial/rebinding_semantics_for_assignment_of_optional_references.html deleted file mode 100644 index ee693eee..00000000 --- a/doc/html/boost_optional/tutorial/rebinding_semantics_for_assignment_of_optional_references.html +++ /dev/null @@ -1,149 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - If you assign to an uninitialized optional<T&> - the effect is to bind (for the first time) to the object. Clearly, there - is no other choice. -

      -
      int x = 1 ;
-int& rx = x ;
-optional<int&> ora ;
-optional<int&> orb(x) ;
-ora = orb ; // now 'ora' is bound to 'x' through 'rx'
-*ora = 2 ; // Changes value of 'x' through 'ora'
-assert(x==2);
-
      -

      - If you assign to a bare C++ reference, the assignment is forwarded to the - referenced object; its value changes but the reference is never rebound. -

      -
      int a = 1 ;
-int& ra = a ;
-int b = 2 ;
-int& rb = b ;
-ra = rb ; // Changes the value of 'a' to 'b'
-assert(a==b);
-b = 3 ;
-assert(ra!=b); // 'ra' is not rebound to 'b'
-
      -

      - Now, if you assign to an initialized optional<T&>, - the effect is to rebind to the new object - instead of assigning the referee. This is unlike bare C++ references. -

      -
      int a = 1 ;
-int b = 2 ;
-int& ra = a ;
-int& rb = b ;
-optional<int&> ora(ra) ;
-optional<int&> orb(rb) ;
-ora = orb ; // 'ora' is rebound to 'b'
-*ora = 3 ; // Changes value of 'b' (not 'a')
-assert(a==1);
-assert(b==3);
-
      -
      - - Rationale -
      -

      - Rebinding semantics for the assignment of initialized - optional references has been - chosen to provide consistency among initialization - states even at the expense of lack of consistency with the semantics - of bare C++ references. It is true that optional<U> - strives to behave as much as possible as U - does whenever it is initialized; but in the case when U - is T&, - doing so would result in inconsistent behavior w.r.t to the lvalue initialization - state. -

      -

      - Imagine optional<T&> - forwarding assignment to the referenced object (thus changing the referenced - object value but not rebinding), and consider the following code: -

      -
      optional<int&> a = get();
-int x = 1 ;
-int& rx = x ;
-optional<int&> b(rx);
-a = b ;
-
      -

      - What does the assignment do? -

      -

      - If a is uninitialized, - the answer is clear: it binds to x - (we now have another reference to x). - But what if a is already - initialized? it would change the value of the referenced - object (whatever that is); which is inconsistent with the other possible - case. -

      -

      - If optional<T&> - would assign just like T& does, you would never be able to use - Optional's assignment without explicitly handling the previous initialization - state unless your code is capable of functioning whether after the assignment, - a aliases the same object - as b or not. -

      -

      - That is, you would have to discriminate in order to be consistent. -

      -

      - If in your code rebinding to another object is not an option, then it is - very likely that binding for the first time isn't either. In such case, assignment - to an uninitialized optional<T&> - shall be prohibited. It is quite possible that in such a scenario it is a - precondition that the lvalue must be already initialized. If it isn't, then - binding for the first time is OK while rebinding is not which is IMO very - unlikely. In such a scenario, you can assign the value itself directly, as - in: -

      -
      assert(!!opt);
-*opt=value;
-
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2016 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/relational_operators.html b/doc/html/boost_optional/tutorial/relational_operators.html deleted file mode 100644 index e384ab07..00000000 --- a/doc/html/boost_optional/tutorial/relational_operators.html +++ /dev/null @@ -1,113 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - Type optional<T> is - EqualityComparable whenever T is EqualityComparable. Two optional - objects containing a value compare in the same way as their contained values. - The uninitialized state of optional<T> - is treated as a distinct value, equal to itself, and unequal to any value - of type T: -

      -
      boost::optional<int> oN = boost::none;
-boost::optional<int> o0 = 0;
-boost::optional<int> o1 = 1;
-
-assert(oN != o0);
-assert(o1 != oN);
-assert(o0 != o1);
-assert(oN == oN);
-assert(o0 == o0);
-
      -

      - The converting constructor from T - as well as from boost::none implies the existence and semantics - of the mixed comparison between T - and optional<T> as - well as between none_t and - optional<T>: -

      -
      assert(oN != 0);
-assert(o1 != boost::none);
-assert(o0 != 1);
-assert(oN == boost::none);
-assert(o0 == 0);
-
      -

      - This mixed comparison has a practical interpretation, which is occasionally - useful: -

      -
      boost::optional<int> choice = ask_user();
-if (choice == 2)
-    start_procedure_2();
-
      -

      - In the above example, the meaning of the comparison is 'user chose number - 2'. If user chose nothing, he didn't choose number 2. -

      -

      - In case where optional<T> is - compared to none, it is not - required that T be EqualityComparable. -

      -

      - In a similar manner, type optional<T> - is LessThanComparable whenever T is LessThanComparable. The optional - object containing no value is compared less than any value of T. To illustrate this, if the default ordering - of size_t is {0, 1, - 2, ...}, the default ordering - of optional<size_t> - is {boost::none, 0, - 1, 2, - ...}. This order does not have a practical interpretation. The goal is to - have any semantically correct default ordering in order for optional<T> to - be usable in ordered associative containers (wherever T - is usable). -

      -

      - Mixed relational operators are the only case where the contained value of - an optional object can be inspected without the usage of value accessing - function (operator*, - value, value_or). -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/type_requirements.html b/doc/html/boost_optional/tutorial/type_requirements.html deleted file mode 100644 index 9eac69df..00000000 --- a/doc/html/boost_optional/tutorial/type_requirements.html +++ /dev/null @@ -1,109 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - The very minimum requirement of optional<T> - is that T is a complete type - and that it has a publicly accessible destructor. T - doesn't even need to be constructible. You can use a very minimum interface: -

      -
      optional<T> o;     // uninitialized
-assert(o == none); // check if initialized
-assert(!o);        //
-o.value();         // always throws
-
      -

      - But this is practically useless. In order for optional<T> - to be able to do anything useful and offer all the spectrum of ways of accessing - the contained value, T needs - to have at least one accessible constructor. In that case you need to initialize - the optional object with function emplace(), or if your compiler does not support it, - resort to In-Place - Factories: -

      -
      optional<T> o;
-o.emplace("T", "ctor", "params");
-
      -

      - If T is MoveConstructible, - optional<T> is - also MoveConstructible and - can be easily initialized from an rvalue of type T - and be passed by value: -

      -
      optional<T> o = make_T();
-optional<T> p = optional<T>();
-
      -

      - If T is CopyConstructible, optional<T> is - also CopyConstructible - and can be easily initialized from an lvalue of type T: -

      -
      T v = make_T();
-optional<T> o = v;
-optional<T> p = o;
-
      -

      - If T is not MoveAssignable, it is still possible to - reset the value of optional<T> - using function emplace(): -

      -
      optional<const T> o = make_T();
-o.emplace(make_another_T());
-
      -

      - If T is Moveable - (both MoveConstructible and - MoveAssignable) then optional<T> is - also Moveable and additionally - can be constructed and assigned from an rvalue of type T. -

      -

      - Similarly, if T is Copyable (both CopyConstructible and CopyAssignable) then optional<T> - is also Copyable and additionally - can be constructed and assigned from an lvalue of type T. -

      -

      - T is not - required to be DefaultConstructible. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/tutorial/when_to_use_optional.html b/doc/html/boost_optional/tutorial/when_to_use_optional.html deleted file mode 100644 index 7fa6810e..00000000 --- a/doc/html/boost_optional/tutorial/when_to_use_optional.html +++ /dev/null @@ -1,142 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - It is recommended to use optional<T> - in situations where there is exactly one, clear (to all parties) reason for - having no value of type T, - and where the lack of value is as natural as having any regular value of - T. One example of such situation - is asking the user in some GUI form to optionally specify some limit on an - int value, but the user is allowed - to say 'I want the number not to be constrained by the maximum'. For another - example, consider a config parameter specifying how many threads the application - should launch. Leaving this parameter unspecified means that the application - should decide itself. For yet another example, consider a function returning - the index of the smallest element in a vector. - We need to be prepared for the situation, where the vector - is empty. Therefore a natural signature for such function would be: -

      -
      template <typename T>
-optional<size_t> find_smallest_elem(const std::vector<T>& vec);
-
      -

      - Here, having received an empty vec - and having no size_t to return - is not a failure but a normal, - albeit irregular, situation. -

      -

      - Another typical situation is to indicate that we do not have a value yet, - but we expect to have it later. This notion can be used in implementing solutions - like lazy initialization or a two-phase initialization. -

      -

      - optional can be used to take - a non-DefaultConstructible type T and create a sibling type with a default - constructor. This is a way to add a null-state to any - type that doesn't have it already. -

      -

      - Sometimes type T already - provides a built-in null-state, but it may still be useful to wrap it into - optional. Consider std::string. - When you read a piece of text from a GUI form or a DB table, it is hardly - ever that the empty string indicates anything else but a missing text. And - some data bases do not even distinguish between a null string entry and a - non-null string of length 0. Still, it may be practical to use optional<string> - to indicate in the returned type that we want to treat the empty string in - a special dedicated program path: -

      -
      if(boost::optional<std::string> name = ask_user_name()) {
-    assert(*name != "");
-    logon_as(*name);
-}
-else {
-    skip_logon();
-}
-
      -

      - In the example above, the assertion indicates that if we choose to use this - technique, we must translate the empty string state to an optional object - with no contained value (inside function ask_user_name). -

      -
      - - Not - recommended usages -
      -

      - It is not recommended to use optional - to indicate that we were not able to compute a value because of a failure. - It is difficult to define what a failure is, but it usually has one common - characteristic: an associated information on the cause of the failure. This - can be the type and member data of an exception object, or an error code. - It is a bad design to signal a failure and not inform about the cause. If - you do not want to use exceptions, and do not like the fact that by returning - error codes you cannot return the computed value, you can use Expected - library. It is sort of Boost.Variant - that contains either a computed value or a reason why the computation failed. -

      -

      - Sometimes the distinction into what is a failure and what is a valid but - irregular result is blurry and depends on a particular usage and personal - preference. Consider a function that converts a string - to an int. Is it a failure that - you cannot convert? It might in some cases, but in other you may call it - exactly for the purpose of figuring out if a given string - is convertible, and you are not even interested in the resulting value. Sometimes - when a conversion fails you may not consider it a failure, but you need to - know why it cannot be converted; for instance at which character it is determined - that the conversion is impossible. In this case returning optional<T> - will not suffice. Finally, there is a use case where an input string that - does not represent an int is - not a failure condition, but during the conversion we use resources whose - acquisition may fail. In that case the natural representation is to both - return optional<int> and - signal failure: -

      -
      optional<int> convert1(const string& str); // throws
-expected<ErrorT, optional<int>> convert2(const string& str); // return either optional or error
-
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/boost_optional/type_requirements.html b/doc/html/boost_optional/type_requirements.html deleted file mode 100644 index e1ee7778..00000000 --- a/doc/html/boost_optional/type_requirements.html +++ /dev/null @@ -1,61 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -

      - At the very minimum for optional<T> - to work with a minimum interface it is required that T - has a publicly accessible no-throw destructor. In that case you need to initialize - the optional object with function emplace() or use InPlaceFactories. - Additionally, if T is Moveable, optional<T> - is also Moveable and can be - easily initialized from an rvalue of type T - and be passed by value. Additionally, if T - is Copyable, optional<T> is - also Copyable and can be easily - initialized from an lvalue of type T. -

      -

      - T is - not required to be Default - Constructible. -

      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/images/opt_align1.png b/doc/html/images/opt_align1.png deleted file mode 100644 index 50e0205eab4aef06bdc02ac4490dd20ca50e887b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 417 zcmeAS@N?(olHy`uVBq!ia0y~yV9W%v1vuD%*=8cRV(+fa+p`U_zvmWtOm(idUVN%_zTQ7>*?qC!j0MGHfWgY( M>FVdQ&MBb@0CoSNbpQYW diff --git a/doc/html/images/opt_align2.png b/doc/html/images/opt_align2.png deleted file mode 100644 index fd7c079c9303f4797523b7ef10c775d2b42f959f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 472 zcmeAS@N?(olHy`uVBq!ia0y~yV9W%v1vuD%*?YcQW5v|j-eluqr}mVk@^Y?Hy-AQ zxD~O!Q*E1*uVcmso;i)l65Q3fz9u)SapjkB_DEFR9e$&t3_qX%+-B;_+ z+q6jI)q(f-xnlm#bAKB)r`G-H-G?`7?>_IHd);=P+ulbDZM#qHK0NvA9b2QHdvc;L zRnGHf*F0@BA=hpCDXr?5w)NR>>wi45<^K9($<3x}f7wU-UhkiO!RoE|?`5a>?B5^0 z{no?k^V!$I5j=5Aa#p>+UA=Ge_qBFb3yUK?fhzL$Uz}KyJQPVY^2Xh!^qEH{s4#5|FE0wsoOJ$Lg+};Pvt?E{*v-#} WC01}`)pr47gTd3)&t;ucLK6U}S-J!O diff --git a/doc/html/images/opt_align3.png b/doc/html/images/opt_align3.png deleted file mode 100644 index 7ca6ec800eb037540b8598efab9014c68701e4ad..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 468 zcmeAS@N?(olHy`uVBq!ia0y~yV9W%v1vuD%Z39%YlSDF>nFWGVcGfTs$Kds^U40^k%1!Lk37$2 z{q=m^p6z9|YU%S2-amF|O8B8^f3-d@GQMWq6}R8W{!yIf>pvlC)zeDmJ-_sRYU<1r z``pD-r|PbMX>j3RyZZ0STYbyk=YF`qy=``=RqyqnYe}g$-@h&Lv0vM_<=KigPkUCy z8k<&6-Ex0L&Xv8J?s#TzQ=2QG$Rgmtz$nh>b*puzB8NglgPMb9cHR>D3N~KXuF#t- zA*7U0x$E*Tp0p#ACr$g?CNrUM#n+ym$Ig!gziXu|u6LGqR*V1k*dSR87!wShu6{1- HoD!MliF_`N=}RMZtFHX(d0zRmL~dE8mFWC-(Te|7Yj5RN zS%y5_e0b~cwEOETPqS88Pd;tF$A{TZ z+5{9F6x0?hNzMzRo7j(f?zmGb&a*hK?Ax_@`*o*l?`}U)l-%X9V7u|ojGfZr{~5EV W#(tY5{-PZi!VI3SelF{r5}E+l@}j2z diff --git a/doc/html/index.html b/doc/html/index.html deleted file mode 100644 index 9f97b8b0..00000000 --- a/doc/html/index.html +++ /dev/null @@ -1,154 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      Next
      -
      -
      -

      -Boost.Optional

      -

      -Fernando Luis Cacciola Carballal -

      -

      Copyright © 2003-2007 Fernando Luis Cacciola Carballal

      -

      Copyright © 2014-2021 Andrzej Krzemieński

      -
      -

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -

      Table of Contents

      -
      -
      Introduction
      -
      Quick Start
      -
      -
      Optional - return values
      -
      Optional - automatic variables
      -
      Optional - data members
      -
      Bypassing - unnecessary default construction
      -
      Storage - in containers
      -
      -
      Tutorial
      -
      -
      Motivation
      -
      Design Overview
      -
      When to - use Optional
      -
      Relational - operators
      -
      IO operators
      -
      Optional - references
      -
      In-Place - Factories
      -
      Gotchas
      -
      Exception - Safety Guarantees
      -
      Type requirements
      -
      Performance - considerations
      -
      -
      Reference
      -
      -
      Header - <boost/none.hpp>
      -
      Header - <boost/optional/bad_optional_access.hpp>
      -
      Header <boost/optional/optional_io.hpp>
      -
      Header - <boost/optional/optional_fwd.hpp>
      -
      Header - <boost/optional/optional.hpp>
      -
      Header - <boost/optional.hpp>
      -
      -
      Dependencies - and Portability
      -
      -
      Dependencies
      -
      Emplace - operations in older compilers
      -
      Optional - Reference Binding
      -
      -
      Release Notes
      -
      Acknowledgements
      -
      -
      -
      -
      -

      - Class template optional is - a wrapper for representing 'optional' (or 'nullable') objects who may not (yet) - contain a valid value. Optional objects offer full value semantics; they are - good for passing by value and usage inside STL containers. This is a header-only - library. -

      -

      - - Problem -

      -

      - Suppose we want to read a parameter from a config file which represents some - integral value, let's call it "MaxValue". - It is possible that this parameter is not specified; such situation is no error. - It is valid to not specify the parameter and in that case the program is supposed - to behave slightly differently. Also, suppose that any possible value of type - int is a valid value for "MaxValue", so we cannot just use - -1 - to represent the absence of the parameter in the config file. -

      -

      - - Solution -

      -

      - This is how you solve it with boost::optional: -

      -
      #include <boost/optional.hpp>
-
-boost::optional<int> getConfigParam(std::string name);  // return either an int or a `not-an-int`
-
-int main()
-{
-  if (boost::optional<int> oi = getConfigParam("MaxValue")) // did I get a real int?
-    runWithMax(*oi);                                        // use my int
-  else
-    runWithNoMax();
-}
-
      -
      -
      - - - -

      Last revised: March 26, 2022 at 22:47:53 GMT

      -
      -
      Next
      - - diff --git a/doc/html/optional/reference.html b/doc/html/optional/reference.html deleted file mode 100644 index 1cbeafab..00000000 --- a/doc/html/optional/reference.html +++ /dev/null @@ -1,89 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      -
      Header - <boost/none.hpp>
      -
      Header - <boost/optional/bad_optional_access.hpp>
      -
      Header <boost/optional/optional_io.hpp>
      -
      Header - <boost/optional/optional_fwd.hpp>
      -
      Header - <boost/optional/optional.hpp>
      -
      Header - <boost/optional.hpp>
      -
      -
      -
      -
      -
      -

      -

      -
      namespace boost {
-
-class none_t {/* see below */};
-
-inline constexpr none_t none (/* see below */);
-
-} // namespace boost
-
      -

      -

      -

      - Class none_t is meant to - serve as a tag for selecting appropriate overloads of from optional's interface. It is an empty, - trivially copyable class with disabled default constructor. -

      -

      - Constant none is used to - indicate an optional object that does not contain a value in initialization, - assignment and relational operations of optional. -

      -
      -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/optional/reference/header__boost_optional_optional_hpp_.html b/doc/html/optional/reference/header__boost_optional_optional_hpp_.html deleted file mode 100644 index c905bfce..00000000 --- a/doc/html/optional/reference/header__boost_optional_optional_hpp_.html +++ /dev/null @@ -1,111 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      -
      -
      // In Header: <boost/optional/optional.hpp>
-
-namespace boost {
-
-class in_place_init_t { /* see below */ } ; R
-const in_place_init_t in_place_init ( /* see below */ ) ;
-
-class in_place_init_if_t { /*see below*/ } ; R
-const in_place_init_if_t in_place_init_if ( /*see below*/ ) ;
-
-template <class T>
-class optional ; R
-
-template <class T>
-class optional<T&> ; R
-
-template<class T> inline bool operator == ( optional<T> const& x, optional<T> const& y ) ; R
-
-template<class T> inline bool operator != ( optional<T> const& x, optional<T> const& y ) ; R
-
-template<class T> inline bool operator <  ( optional<T> const& x, optional<T> const& y ) ; R
-
-template<class T> inline bool operator >  ( optional<T> const& x, optional<T> const& y ) ; R
-
-template<class T> inline bool operator <= ( optional<T> const& x, optional<T> const& y ) ; R
-
-template<class T> inline bool operator >= ( optional<T> const& x, optional<T> const& y ) ; R
-
-template<class T> inline bool operator == ( optional<T> const& x, none_t ) noexcept ; R
-
-template<class T> inline bool operator != ( optional<T> const& x, none_t ) noexcept ; R
-
-template<class T> inline optional<T> make_optional ( T const& v ) ; R
-
-template<class T> inline optional<std::decay_t<T>> make_optional ( T && v ) ; R
-
-template<class T> inline optional<T> make_optional ( bool condition, T const& v ) ; R
-
-template<class T> inline optional<std::decay_t<T>> make_optional ( bool condition, T && v ) ; R
-
-template<class T> inline auto get_optional_value_or ( optional<T> const& opt, typename optional<T>::reference_const_type def ) -> typename optional<T>::reference_const_type; R
-
-template<class T> inline auto get_optional_value_or ( optional<T> const& opt, typename optional<T>::reference_type def ) -> typename optional<T>::reference_type ; R
-
-template<class T> inline T const& get ( optional<T> const& opt ) ; R
-
-template<class T> inline T& get ( optional<T> & opt ) ; R
-
-template<class T> inline T const* get ( optional<T> const* opt ) ; R
-
-template<class T> inline T* get ( optional<T>* opt ) ; R
-
-template<class T> inline auto get_pointer ( optional<T> const& opt ) -> see below; R
-
-template<class T> inline auto get_pointer ( optional<T> & opt ) -> see below; R
-
-template<class T> inline void swap( optional<T>& x, optional<T>& y ) ; R
-
-template<class T> inline void swap( optional<T&>& x, optional<T&>& y ) ; R
-
-} // namespace boost
-
      -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/optional/tutorial.html b/doc/html/optional/tutorial.html deleted file mode 100644 index 1331750c..00000000 --- a/doc/html/optional/tutorial.html +++ /dev/null @@ -1,153 +0,0 @@ - - - -Codestin Search App - - - - - - - - - - - - - - - -
      Boost C++ LibrariesHomeLibrariesPeopleFAQMore
      -
      -
      -PrevUpHomeNext -
      -
      -
      -
      -
      Motivation
      -
      Design Overview
      -
      When to - use Optional
      -
      Relational - operators
      -
      IO operators
      -
      Optional - references
      -
      In-Place - Factories
      -
      Gotchas
      -
      Exception - Safety Guarantees
      -
      Type requirements
      -
      Performance - considerations
      -
      -
      -
      -

      - Consider these functions which should return a value but which might not - have a value to return: -

      -
        -
      • - (A) double sqrt(double n ); -
        • -
      • - (B) char get_async_input(); -
        • -
      • - (C) point polygon::get_any_point_effectively_inside(); -
        • -
      -

      - There are different approaches to the issue of not having a value to return. -

      -

      - A typical approach is to consider the existence of a valid return value as - a postcondition, so that if the function cannot compute the value to return, - it has either undefined behavior (and can use assert in a debug build) or - uses a runtime check and throws an exception if the postcondition is violated. - This is a reasonable choice for example, for function (A), because the lack - of a proper return value is directly related to an invalid parameter (out - of domain argument), so it is appropriate to require the callee to supply - only parameters in a valid domain for execution to continue normally. -

      -

      - However, function (B), because of its asynchronous nature, does not fail - just because it can't find a value to return; so it is incorrect to consider - such a situation an error and assert or throw an exception. This function - must return, and somehow, must tell the callee that it is not returning a - meaningful value. -

      -

      - A similar situation occurs with function (C): it is conceptually an error - to ask a null-area polygon to return a point inside - itself, but in many applications, it is just impractical for performance - reasons to treat this as an error (because detecting that the polygon has - no area might be too expensive to be required to be tested previously), and - either an arbitrary point (typically at infinity) is returned, or some efficient - way to tell the callee that there is no such point is used. -

      -

      - There are various mechanisms to let functions communicate that the returned - value is not valid. One such mechanism, which is quite common since it has - zero or negligible overhead, is to use a special value which is reserved - to communicate this. Classical examples of such special values are EOF, string::npos, - points at infinity, etc... -

      -

      - When those values exist, i.e. the return type can hold all meaningful values - plus the signal value, this mechanism - is quite appropriate and well known. Unfortunately, there are cases when - such values do not exist. In these cases, the usual alternative is either - to use a wider type, such as int - in place of char; or a compound - type, such as std::pair<point,bool>. -

      -

      - Returning a std::pair<T,bool>, thus attaching a boolean flag to the - result which indicates if the result is meaningful, has the advantage that - can be turned into a consistent idiom since the first element of the pair - can be whatever the function would conceptually return. For example, the - last two functions could have the following interface: -

      -
      std::pair<char,bool> get_async_input();
-std::pair<point,bool> polygon::get_any_point_effectively_inside();
-
      -

      - These functions use a consistent interface for dealing with possibly nonexistent - results: -

      -
      std::pair<point,bool> p = poly.get_any_point_effectively_inside();
-if ( p.second )
-    flood_fill(p.first);
-
      -

      - However, not only is this quite a burden syntactically, it is also error - prone since the user can easily use the function result (first element of - the pair) without ever checking if it has a valid value. -

      -

      - Clearly, we need a better idiom. -

      -
      -
      - - - -
      Copyright © 2003-2007 Fernando Luis Cacciola Carballal
      Copyright © 2014-2021 Andrzej Krzemieński

      - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) -

      -
      -
      -
      -PrevUpHomeNext -
      - - diff --git a/doc/html/images/callouts/R.png b/doc/images/R.png similarity index 100% rename from doc/html/images/callouts/R.png rename to doc/images/R.png diff --git a/doc/html/images/space.png b/doc/images/space.png similarity index 100% rename from doc/html/images/space.png rename to doc/images/space.png From 01e80d2b87e013f503f85e88a63d6c8d1d4b678d Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Wed, 3 Jan 2024 21:41:26 +0100 Subject: [PATCH 096/163] drop dependency on boost.detail --- doc/90_dependencies.qbk | 25 +- doc/91_relnotes.qbk | 1 + .../optional/detail/experimental_traits.hpp | 14 +- .../boost/optional/detail/optional_config.hpp | 4 +- include/boost/optional/optional.hpp | 8 - test/Jamfile.v2 | 1 - test/optional_test.cpp | 3 + test/optional_test_old_impl.cpp | 223 ------------------ test/optional_test_swap.cpp | 9 +- test/optional_test_wuninitialized.cpp | 3 +- 10 files changed, 34 insertions(+), 257 deletions(-) delete mode 100644 test/optional_test_old_impl.cpp diff --git a/doc/90_dependencies.qbk b/doc/90_dependencies.qbk index d383905c..0dab296e 100644 --- a/doc/90_dependencies.qbk +++ b/doc/90_dependencies.qbk @@ -17,7 +17,6 @@ The implementation uses the following other Boost modules: # assert # config # core -# detail # move # mpl # static_assert @@ -34,15 +33,15 @@ Certain constructors and functions in the interface of `optional` perform a 'per template optional(in_place_init_t, Args&&... args); template optional(in_place_init_if_t, bool condition, Args&&... args); template void emplace(Args&&... args); - + On compilers that do not support variadic templates, each of these functions is substituted with two overloads, one forwarding a single argument, the other forwarding zero arguments. This forms the following set: template optional(in_place_init_t, Arg&& arg); optional(in_place_init_t); - + template optional(in_place_init_if_t, bool condition, Arg&& arg); optional(in_place_init_if_t, bool condition); - + template void emplace(Arg&& arg); void emplace(); @@ -51,16 +50,16 @@ On compilers that do not support rvalue references, each of these functions is s template optional(in_place_init_t, const Arg& arg); template optional(in_place_init_t, Arg& arg); optional(in_place_init_t); - + template optional(in_place_init_if_t, bool condition, const Arg& arg); template optional(in_place_init_if_t, bool condition, Arg& arg); optional(in_place_init_if_t, bool condition); - + template void emplace(const Arg& arg); template void emplace(Arg& arg); void emplace(); -This workaround addresses about 40% of all use cases. If this is insufficient, you need to resort to using [link boost_optional.tutorial.in_place_factories In-Place Factories]. +This workaround addresses about 40% of all use cases. If this is insufficient, you need to resort to using [link boost_optional.tutorial.in_place_factories In-Place Factories]. [endsect] [section Optional Reference Binding][#optional_reference_binding] @@ -71,11 +70,11 @@ A number of compilers incorrectly treat const lvalues of integral type as rvalue optional or1; optional or2 = i; // caution: not portable or1 = i; // caution: not portable - + optional or3(i); // portable or1 = optional(i); // portable -Compilers known to have these deficiencies include GCC versions 4.2, 4.3, 4.4, 4.5, 5.1, 5.2; QCC 4.4.2; MSVC versions 8.0, 9.0, 10.0, 11.0, 12.0. In order to check if your compiler correctly implements reference binding use this test program. +Compilers known to have these deficiencies include GCC versions 4.2, 4.3, 4.4, 4.5, 5.1, 5.2; QCC 4.4.2; MSVC versions 8.0, 9.0, 10.0, 11.0, 12.0. In order to check if your compiler correctly implements reference binding use this test program. #include @@ -88,13 +87,13 @@ Compilers known to have these deficiencies include GCC versions 4.2, 4.3, 4.4, 4 assert(&ii == &global_i); } - void operator=(const int& ii) + void operator=(const int& ii) { assert(&ii == &global_i); } void operator=(int&&) // remove this if your compiler doesn't have rvalue refs - { + { assert(false); } }; @@ -110,7 +109,7 @@ Compilers known to have these deficiencies include GCC versions 4.2, 4.3, 4.4, 4 TestingReferenceBinding ttt2 = iref; ttt2 = iref; } - + [endsect] -[endsect] \ No newline at end of file +[endsect] diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index 8105455d..cadccbec 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -15,6 +15,7 @@ * Fixed the implementation for trivial types. Now it is slower, because it always initializes the `T`, but it avoids undefined behavior when `optional` is copied. This fixes [@https://github.com/boostorg/optional/issues/108 issue #108]. * Fixed some `-Wmaybe-uninitialized` warnings in GCC 12. Thanks to Christian Mazakas for the fix. +* Dropped dependency on Boost.Detail. [heading Boost Release 1.83] diff --git a/include/boost/optional/detail/experimental_traits.hpp b/include/boost/optional/detail/experimental_traits.hpp index b51f5f10..56670346 100644 --- a/include/boost/optional/detail/experimental_traits.hpp +++ b/include/boost/optional/detail/experimental_traits.hpp @@ -13,10 +13,10 @@ #define BOOST_OPTIONAL_DETAIL_EXPERIMENTAL_TRAITS_04NOV2017_HPP #include -#include +#include #include #include - + // The condition to use POD implementation #ifdef BOOST_OPTIONAL_CONFIG_NO_POD_SPEC @@ -50,7 +50,7 @@ # define BOOST_OPTIONAL_DETAIL_USE_STD_TYPE_TRAITS # endif # endif -#endif +#endif #ifndef BOOST_OPTIONAL_DETAIL_USE_STD_TYPE_TRAITS @@ -59,10 +59,10 @@ # include # define BOOST_OPTIONAL_DETAIL_HAS_TRIVIAL_CTOR(T) std::is_trivially_default_constructible::value #endif - - + + namespace boost { namespace optional_detail { - + #ifndef BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES template struct is_type_trivially_copyable @@ -83,7 +83,7 @@ struct is_type_trivially_copyable -#ifndef BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES +#ifndef BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES template struct optional_uses_direct_storage_for_ : boost::conditional< (is_type_trivially_copyable::value && BOOST_OPTIONAL_DETAIL_HAS_TRIVIAL_CTOR(T)) || diff --git a/include/boost/optional/detail/optional_config.hpp b/include/boost/optional/detail/optional_config.hpp index b5040a47..3e5e282f 100644 --- a/include/boost/optional/detail/optional_config.hpp +++ b/include/boost/optional/detail/optional_config.hpp @@ -14,7 +14,7 @@ #define BOOST_OPTIONAL_DETAIL_OPTIONAL_CONFIG_AJK_28JAN2015_HPP #include -#include +#include #if (defined BOOST_NO_CXX11_RVALUE_REFERENCES) || (defined BOOST_OPTIONAL_CONFIG_NO_RVALUE_REFERENCES) # define BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES @@ -55,7 +55,7 @@ #if (defined(_MSC_VER) && _MSC_VER <= 1800) // on MSVC 2013 and earlier an unwanted temporary is created when you assign from // a const lvalue of integral type. Thus we bind not to the original address but -// to a temporary. +// to a temporary. # define BOOST_OPTIONAL_CONFIG_NO_PROPER_ASSIGN_FROM_CONST_INT #endif diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 2a183c54..99245ff4 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -83,9 +83,6 @@ struct optional_value_type< ::boost::optional > }} // namespace boost::optional_detail -#ifdef BOOST_OPTIONAL_CONFIG_USE_OLD_IMPLEMENTATION_OF_OPTIONAL -#include -#else namespace boost { namespace optional_ns { @@ -1513,11 +1510,6 @@ class optional BOOST_EXPLICIT_OPERATOR_BOOL_NOEXCEPT() } ; -} // namespace boost - -#endif // BOOST_OPTIONAL_CONFIG_USE_OLD_IMPLEMENTATION_OF_OPTIONAL - -namespace boost { #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES template diff --git a/test/Jamfile.v2 b/test/Jamfile.v2 index c5e68bbf..1906eb49 100644 --- a/test/Jamfile.v2 +++ b/test/Jamfile.v2 @@ -44,7 +44,6 @@ import testing ; [ run optional_test_io.cpp ] [ run optional_test_move.cpp ] [ run optional_test_noexcept_move.cpp ] - [ run optional_test_old_impl.cpp ] [ run optional_test_equals_none.cpp ] [ run optional_test_value_access.cpp ] [ run optional_test_emplace.cpp ] diff --git a/test/optional_test.cpp b/test/optional_test.cpp index 5ec00162..81375b8d 100644 --- a/test/optional_test.cpp +++ b/test/optional_test.cpp @@ -849,6 +849,8 @@ struct VBase : virtual X VBase(int v) : X(v) {} // MSVC 8.0 doesn't generate this correctly... VBase(const VBase& other) : X(static_cast(other)) {} + + VBase& operator=(VBase const& rhs) { X::operator=(rhs); return *this; } }; void test_with_class_type() @@ -917,6 +919,7 @@ class CustomAddressOfClass public: CustomAddressOfClass() : n(0) {} CustomAddressOfClass(CustomAddressOfClass const& that) : n(that.n) {} + CustomAddressOfClass& operator=(CustomAddressOfClass const& rhs) { n = rhs.n; return *this; } explicit CustomAddressOfClass(int m) : n(m) {} int* operator& () { return &n; } bool operator== (CustomAddressOfClass const& that) const { return n == that.n; } diff --git a/test/optional_test_old_impl.cpp b/test/optional_test_old_impl.cpp deleted file mode 100644 index f3da56e1..00000000 --- a/test/optional_test_old_impl.cpp +++ /dev/null @@ -1,223 +0,0 @@ -// Copyright (C) 2014 - 2018 Andrzej Krzemienski. -// -// Use, modification, and distribution is subject to the Boost Software -// License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at -// http://www.boost.org/LICENSE_1_0.txt) -// -// See http://www.boost.org/lib/optional for documentation. -// -// You are welcome to contact the author at: -// akrzemi1@gmail.com - -#define BOOST_OPTIONAL_CONFIG_USE_OLD_IMPLEMENTATION_OF_OPTIONAL // does old implementation still work for basic usage? -#include "boost/optional/optional.hpp" - -#ifdef BOOST_BORLANDC -#pragma hdrstop -#endif - -#include "boost/core/ignore_unused.hpp" -#include "boost/core/lightweight_test.hpp" - -using boost::optional; - -struct IntWrapper -{ - int _i; - IntWrapper(int i) : _i(i) {} - bool operator==(IntWrapper const& rhs) const { return _i == rhs._i; } -}; - -template -void test_function_value_or_for() -{ - optional oM0; - const optional oC0; - optional oM1(1); - const optional oC2(2); - - BOOST_TEST(oM0.value_or(5) == 5); - BOOST_TEST(oC0.value_or(5) == 5); - BOOST_TEST(oM1.value_or(5) == 1); - BOOST_TEST(oC2.value_or(5) == 2); -} - -template -void test_function_value_for() -{ - optional o0; - optional o1(1); - const optional oC(2); - - try - { - T& v = o1.value(); - BOOST_TEST(v == 1); - } - catch(...) - { - BOOST_TEST(false); - } - - try - { - T const& v = oC.value(); - BOOST_TEST(v == 2); - } - catch(...) - { - BOOST_TEST(false); - } - - BOOST_TEST_THROWS(o0.value(), boost::bad_optional_access); -} - -void test_function_value() -{ - test_function_value_for(); - test_function_value_for(); - test_function_value_for(); -} - -struct FatToIntConverter -{ - static int conversions; - int _val; - FatToIntConverter(int val) : _val(val) {} - operator int() const { conversions += 1; return _val; } -}; - -int FatToIntConverter::conversions = 0; - -void test_function_value_or() -{ - test_function_value_or_for(); - test_function_value_or_for(); - test_function_value_or_for(); - - optional oi(1); - BOOST_TEST(oi.value_or(FatToIntConverter(2)) == 1); - BOOST_TEST(FatToIntConverter::conversions == 0); - - oi = boost::none; - BOOST_TEST(oi.value_or(FatToIntConverter(2)) == 2); - BOOST_TEST(FatToIntConverter::conversions == 1); -} - - -struct FunM -{ - int operator()() { return 5; } -}; - -struct FunC -{ - int operator()() const { return 6; } -}; - -int funP () -{ - return 7; -} - -int throw_() -{ - throw int(); -} - -void test_function_value_or_eval() -{ - optional o1 = 1; - optional oN; - FunM funM; - FunC funC; - - BOOST_TEST_EQ(o1.value_or_eval(funM), 1); - BOOST_TEST_EQ(oN.value_or_eval(funM), 5); - BOOST_TEST_EQ(o1.value_or_eval(FunM()), 1); - BOOST_TEST_EQ(oN.value_or_eval(FunM()), 5); - - BOOST_TEST_EQ(o1.value_or_eval(funC), 1); - BOOST_TEST_EQ(oN.value_or_eval(funC), 6); - BOOST_TEST_EQ(o1.value_or_eval(FunC()), 1); - BOOST_TEST_EQ(oN.value_or_eval(FunC()), 6); - - BOOST_TEST_EQ(o1.value_or_eval(funP), 1); - BOOST_TEST_EQ(oN.value_or_eval(funP), 7); - -#ifndef BOOST_NO_CXX11_LAMBDAS - BOOST_TEST_EQ(o1.value_or_eval([](){return 8;}), 1); - BOOST_TEST_EQ(oN.value_or_eval([](){return 8;}), 8); -#endif - - try - { - BOOST_TEST_EQ(o1.value_or_eval(throw_), 1); - } - catch(...) - { - BOOST_TEST(false); - } - - BOOST_TEST_THROWS(oN.value_or_eval(throw_), int); -} - -const optional makeConstOptVal() -{ - return std::string("something"); -} - -void test_const_move() -{ - std::string s5 = *makeConstOptVal(); - std::string s6 = makeConstOptVal().value(); - boost::ignore_unused(s5); - boost::ignore_unused(s6); -} - - -#if (!defined BOOST_NO_CXX11_REF_QUALIFIERS) && (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) -struct MoveOnly -{ - explicit MoveOnly(int){} - MoveOnly(MoveOnly &&){} - void operator=(MoveOnly &&); -private: - MoveOnly(MoveOnly const&); - void operator=(MoveOnly const&); -}; - -optional makeMoveOnly() -{ - return MoveOnly(1); -} - -MoveOnly moveOnlyDefault() -{ - return MoveOnly(1); -} - -// compile-time test -void test_move_only_getters() -{ - MoveOnly m1 = *makeMoveOnly(); - MoveOnly m2 = makeMoveOnly().value(); - MoveOnly m3 = makeMoveOnly().value_or(MoveOnly(1)); - MoveOnly m4 = makeMoveOnly().value_or_eval(moveOnlyDefault); - boost::ignore_unused(m1); - boost::ignore_unused(m2); - boost::ignore_unused(m3); - boost::ignore_unused(m4); -} - -#endif // !defined BOOST_NO_CXX11_REF_QUALIFIERS - -int main() -{ - test_function_value(); - test_function_value_or(); - test_function_value_or_eval(); - test_const_move(); - - return boost::report_errors(); -} diff --git a/test/optional_test_swap.cpp b/test/optional_test_swap.cpp index 2294c703..d997ef6c 100644 --- a/test/optional_test_swap.cpp +++ b/test/optional_test_swap.cpp @@ -53,6 +53,9 @@ namespace optional_swap_test throw assignment_exception(); } + base_class_with_forbidden_assignment() {} + base_class_with_forbidden_assignment(base_class_with_forbidden_assignment const&) {} + virtual ~base_class_with_forbidden_assignment() {} }; @@ -94,7 +97,8 @@ namespace optional_swap_test class_whose_default_ctor_should_be_used() : data('\0') { } - class_whose_default_ctor_should_be_used(const class_whose_default_ctor_should_be_used &) + class_whose_default_ctor_should_be_used(const class_whose_default_ctor_should_be_used & rhs) + : base_class_with_forbidden_assignment(rhs) { BOOST_TEST(!"This copy constructor should not be used while swapping!"); throw copy_ctor_exception(); @@ -137,7 +141,8 @@ namespace optional_swap_test throw default_ctor_exception(); } - class_whose_explicit_ctor_should_be_used(const class_whose_explicit_ctor_should_be_used &) + class_whose_explicit_ctor_should_be_used(const class_whose_explicit_ctor_should_be_used & rhs) + : base_class_with_forbidden_assignment(rhs) { BOOST_TEST(!"This copy constructor should not be used while swapping!"); throw copy_ctor_exception(); diff --git a/test/optional_test_wuninitialized.cpp b/test/optional_test_wuninitialized.cpp index 2e6bf2ca..9249c31a 100644 --- a/test/optional_test_wuninitialized.cpp +++ b/test/optional_test_wuninitialized.cpp @@ -123,6 +123,7 @@ void test_basics( ) optional oa ( a ) ; + optional ob ( a ); check_initialized(oa); oa = a ; @@ -132,7 +133,7 @@ void test_basics( ) optional const oa2 ( oa ) ; check_initialized_const(oa2); - oa = oa ; + oa = ob ; check_initialized(oa); oa = def ; From 8375df7693340c4182121b9df8cfe8199e65eb33 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Wed, 3 Jan 2024 22:20:28 +0100 Subject: [PATCH 097/163] Fix MSVC 14.1 compiler crash --- .../detail/old_optional_implementation.hpp | 1059 ----------------- .../detail/optional_aligned_storage.hpp | 5 + 2 files changed, 5 insertions(+), 1059 deletions(-) delete mode 100644 include/boost/optional/detail/old_optional_implementation.hpp diff --git a/include/boost/optional/detail/old_optional_implementation.hpp b/include/boost/optional/detail/old_optional_implementation.hpp deleted file mode 100644 index 36f1a8de..00000000 --- a/include/boost/optional/detail/old_optional_implementation.hpp +++ /dev/null @@ -1,1059 +0,0 @@ -// Copyright (C) 2003, 2008 Fernando Luis Cacciola Carballal. -// Copyright (C) 2014-2016 Andrzej Krzemienski. -// -// Use, modification, and distribution is subject to the Boost Software -// License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at -// http://www.boost.org/LICENSE_1_0.txt) -// -// See http://www.boost.org/libs/optional for documentation. -// -// You are welcome to contact the maintainer at: -// akrzemi1@gmail.com - -#ifndef BOOST_OPTIONAL_DETAIL_OLD_OPTIONAL_IMPLEMENTATION_AJK_28JAN2015_HPP -#define BOOST_OPTIONAL_DETAIL_OLD_OPTIONAL_IMPLEMENTATION_AJK_28JAN2015_HPP - -#include -#include -#include -#include -#include - -namespace boost { - -namespace optional_detail { - - -template -struct types_when_isnt_ref -{ - typedef T const& reference_const_type ; - typedef T & reference_type ; -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - typedef T && rval_reference_type ; - typedef T && reference_type_of_temporary_wrapper; -#ifdef BOOST_MOVE_OLD_RVALUE_REF_BINDING_RULES - // GCC 4.4 has support for an early draft of rvalue references. The conforming version below - // causes warnings about returning references to a temporary. - static T&& move(T&& r) { return r; } -#else - static rval_reference_type move(reference_type r) { return boost::move(r); } -#endif -#endif - typedef T const* pointer_const_type ; - typedef T * pointer_type ; - typedef T const& argument_type ; -} ; - -template -struct types_when_is_ref -{ - typedef BOOST_DEDUCED_TYPENAME remove_reference::type raw_type ; - - typedef raw_type& reference_const_type ; - typedef raw_type& reference_type ; -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - typedef BOOST_DEDUCED_TYPENAME remove_const::type&& rval_reference_type ; - typedef raw_type& reference_type_of_temporary_wrapper; - static reference_type move(reference_type r) { return r; } -#endif - typedef raw_type* pointer_const_type ; - typedef raw_type* pointer_type ; - typedef raw_type& argument_type ; -} ; - -template -void prevent_binding_rvalue_ref_to_optional_lvalue_ref() -{ -#ifndef BOOST_OPTIONAL_CONFIG_ALLOW_BINDING_TO_RVALUES - BOOST_STATIC_ASSERT_MSG( - !boost::is_lvalue_reference::value || !boost::is_rvalue_reference::value, - "binding rvalue references to optional lvalue references is disallowed"); -#endif -} - -struct optional_tag {} ; - -template -class optional_base : public optional_tag -{ - private : - - typedef -#if !BOOST_WORKAROUND(BOOST_BORLANDC, BOOST_TESTED_AT(0x564)) - BOOST_DEDUCED_TYPENAME -#endif - ::boost::detail::make_reference_content::type internal_type ; - - typedef aligned_storage storage_type ; - - typedef types_when_isnt_ref types_when_not_ref ; - typedef types_when_is_ref types_when_ref ; - - typedef optional_base this_type ; - - protected : - - typedef T value_type ; - - typedef true_type is_reference_tag ; - typedef false_type is_not_reference_tag ; - - typedef BOOST_DEDUCED_TYPENAME is_reference::type is_reference_predicate ; - - public: - typedef BOOST_DEDUCED_TYPENAME conditional::type types ; - - protected: - typedef BOOST_DEDUCED_TYPENAME types::reference_type reference_type ; - typedef BOOST_DEDUCED_TYPENAME types::reference_const_type reference_const_type ; -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - typedef BOOST_DEDUCED_TYPENAME types::rval_reference_type rval_reference_type ; - typedef BOOST_DEDUCED_TYPENAME types::reference_type_of_temporary_wrapper reference_type_of_temporary_wrapper ; -#endif - typedef BOOST_DEDUCED_TYPENAME types::pointer_type pointer_type ; - typedef BOOST_DEDUCED_TYPENAME types::pointer_const_type pointer_const_type ; - typedef BOOST_DEDUCED_TYPENAME types::argument_type argument_type ; - - // Creates an optional uninitialized. - // No-throw - optional_base() - : - m_initialized(false) {} - - // Creates an optional uninitialized. - // No-throw - optional_base ( none_t ) - : - m_initialized(false) {} - - // Creates an optional initialized with 'val'. - // Can throw if T::T(T const&) does - optional_base ( argument_type val ) - : - m_initialized(false) - { - construct(val); - } - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - // move-construct an optional initialized from an rvalue-ref to 'val'. - // Can throw if T::T(T&&) does - optional_base ( rval_reference_type val ) - : - m_initialized(false) - { - construct( boost::move(val) ); - } -#endif - - // Creates an optional initialized with 'val' IFF cond is true, otherwise creates an uninitialized optional. - // Can throw if T::T(T const&) does - optional_base ( bool cond, argument_type val ) - : - m_initialized(false) - { - if ( cond ) - construct(val); - } - - // Creates a deep copy of another optional - // Can throw if T::T(T const&) does - optional_base ( optional_base const& rhs ) - : - m_initialized(false) - { - if ( rhs.is_initialized() ) - construct(rhs.get_impl()); - } - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - // Creates a deep move of another optional - // Can throw if T::T(T&&) does - optional_base ( optional_base&& rhs ) - : - m_initialized(false) - { - if ( rhs.is_initialized() ) - construct( boost::move(rhs.get_impl()) ); - } -#endif - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - - template - explicit optional_base ( Expr&& expr, PtrExpr const* tag ) - : - m_initialized(false) - { - construct(boost::forward(expr),tag); - } - -#else - // This is used for both converting and in-place constructions. - // Derived classes use the 'tag' to select the appropriate - // implementation (the correct 'construct()' overload) - template - explicit optional_base ( Expr const& expr, Expr const* tag ) - : - m_initialized(false) - { - construct(expr,tag); - } - -#endif - - - // No-throw (assuming T::~T() doesn't) - ~optional_base() { destroy() ; } - - // Assigns from another optional (deep-copies the rhs value) - void assign ( optional_base const& rhs ) - { - if (is_initialized()) - { - if ( rhs.is_initialized() ) - assign_value(rhs.get_impl(), is_reference_predicate() ); - else destroy(); - } - else - { - if ( rhs.is_initialized() ) - construct(rhs.get_impl()); - } - } - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - // Assigns from another optional (deep-moves the rhs value) - void assign ( optional_base&& rhs ) - { - if (is_initialized()) - { - if ( rhs.is_initialized() ) - assign_value(boost::move(rhs.get_impl()), is_reference_predicate() ); - else destroy(); - } - else - { - if ( rhs.is_initialized() ) - construct(boost::move(rhs.get_impl())); - } - } -#endif - - // Assigns from another _convertible_ optional (deep-copies the rhs value) - template - void assign ( optional const& rhs ) - { - if (is_initialized()) - { - if ( rhs.is_initialized() ) -#ifndef BOOST_OPTIONAL_CONFIG_RESTORE_ASSIGNMENT_OF_NONCONVERTIBLE_TYPES - assign_value(rhs.get(), is_reference_predicate() ); -#else - assign_value(static_cast(rhs.get()), is_reference_predicate() ); -#endif - - else destroy(); - } - else - { - if ( rhs.is_initialized() ) -#ifndef BOOST_OPTIONAL_CONFIG_RESTORE_ASSIGNMENT_OF_NONCONVERTIBLE_TYPES - construct(rhs.get()); -#else - construct(static_cast(rhs.get())); -#endif - } - } - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - // move-assigns from another _convertible_ optional (deep-moves from the rhs value) - template - void assign ( optional&& rhs ) - { - typedef BOOST_DEDUCED_TYPENAME optional::rval_reference_type ref_type; - if (is_initialized()) - { - if ( rhs.is_initialized() ) - assign_value(static_cast(rhs.get()), is_reference_predicate() ); - else destroy(); - } - else - { - if ( rhs.is_initialized() ) - construct(static_cast(rhs.get())); - } - } -#endif - - // Assigns from a T (deep-copies the rhs value) - void assign ( argument_type val ) - { - if (is_initialized()) - assign_value(val, is_reference_predicate() ); - else construct(val); - } - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - // Assigns from a T (deep-moves the rhs value) - void assign ( rval_reference_type val ) - { - if (is_initialized()) - assign_value( boost::move(val), is_reference_predicate() ); - else construct( boost::move(val) ); - } -#endif - - // Assigns from "none", destroying the current value, if any, leaving this UNINITIALIZED - // No-throw (assuming T::~T() doesn't) - void assign ( none_t ) BOOST_NOEXCEPT { destroy(); } - -#ifndef BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - template - void assign_expr ( Expr&& expr, ExprPtr const* tag ) - { - if (is_initialized()) - assign_expr_to_initialized(boost::forward(expr),tag); - else construct(boost::forward(expr),tag); - } -#else - template - void assign_expr ( Expr const& expr, Expr const* tag ) - { - if (is_initialized()) - assign_expr_to_initialized(expr,tag); - else construct(expr,tag); - } -#endif - -#endif - - public : - - // Destroys the current value, if any, leaving this UNINITIALIZED - // No-throw (assuming T::~T() doesn't) - void reset() BOOST_NOEXCEPT { destroy(); } - - // **DEPRECATED** Replaces the current value -if any- with 'val' - void reset ( argument_type val ) { assign(val); } - - // Returns a pointer to the value if this is initialized, otherwise, - // returns NULL. - // No-throw - pointer_const_type get_ptr() const { return m_initialized ? get_ptr_impl() : 0 ; } - pointer_type get_ptr() { return m_initialized ? get_ptr_impl() : 0 ; } - - bool is_initialized() const { return m_initialized ; } - - protected : - - void construct ( argument_type val ) - { - ::new (m_storage.address()) internal_type(val) ; - m_initialized = true ; - } - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - void construct ( rval_reference_type val ) - { - ::new (m_storage.address()) internal_type( types::move(val) ) ; - m_initialized = true ; - } -#endif - - -#if (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) && (!defined BOOST_NO_CXX11_VARIADIC_TEMPLATES) - // Constructs in-place - // upon exception *this is always uninitialized - template - void emplace_assign ( Args&&... args ) - { - destroy(); - ::new (m_storage.address()) internal_type( boost::forward(args)... ); - m_initialized = true ; - } -#elif (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) - template - void emplace_assign ( Arg&& arg ) - { - destroy(); - ::new (m_storage.address()) internal_type( boost::forward(arg) ); - m_initialized = true ; - } - - void emplace_assign () - { - destroy(); - ::new (m_storage.address()) internal_type(); - m_initialized = true ; - } -#else - template - void emplace_assign ( const Arg& arg ) - { - destroy(); - ::new (m_storage.address()) internal_type( arg ); - m_initialized = true ; - } - - template - void emplace_assign ( Arg& arg ) - { - destroy(); - ::new (m_storage.address()) internal_type( arg ); - m_initialized = true ; - } - - void emplace_assign () - { - destroy(); - ::new (m_storage.address()) internal_type(); - m_initialized = true ; - } -#endif - -#ifndef BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - // Constructs in-place using the given factory - template - void construct ( Expr&& factory, in_place_factory_base const* ) - { - BOOST_STATIC_ASSERT ( !is_reference_predicate::value ) ; - boost_optional_detail::construct(factory, m_storage.address()); - m_initialized = true ; - } - - // Constructs in-place using the given typed factory - template - void construct ( Expr&& factory, typed_in_place_factory_base const* ) - { - BOOST_STATIC_ASSERT ( !is_reference_predicate::value ) ; - factory.apply(m_storage.address()) ; - m_initialized = true ; - } - - template - void assign_expr_to_initialized ( Expr&& factory, in_place_factory_base const* tag ) - { - destroy(); - construct(factory,tag); - } - - // Constructs in-place using the given typed factory - template - void assign_expr_to_initialized ( Expr&& factory, typed_in_place_factory_base const* tag ) - { - destroy(); - construct(factory,tag); - } - -#else - // Constructs in-place using the given factory - template - void construct ( Expr const& factory, in_place_factory_base const* ) - { - BOOST_STATIC_ASSERT ( !is_reference_predicate::value ) ; - boost_optional_detail::construct(factory, m_storage.address()); - m_initialized = true ; - } - - // Constructs in-place using the given typed factory - template - void construct ( Expr const& factory, typed_in_place_factory_base const* ) - { - BOOST_STATIC_ASSERT ( !is_reference_predicate::value ) ; - factory.apply(m_storage.address()) ; - m_initialized = true ; - } - - template - void assign_expr_to_initialized ( Expr const& factory, in_place_factory_base const* tag ) - { - destroy(); - construct(factory,tag); - } - - // Constructs in-place using the given typed factory - template - void assign_expr_to_initialized ( Expr const& factory, typed_in_place_factory_base const* tag ) - { - destroy(); - construct(factory,tag); - } -#endif - -#endif - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - // Constructs using any expression implicitly convertible to the single argument - // of a one-argument T constructor. - // Converting constructions of optional from optional uses this function with - // 'Expr' being of type 'U' and relying on a converting constructor of T from U. - template - void construct ( Expr&& expr, void const* ) - { - new (m_storage.address()) internal_type(boost::forward(expr)) ; - m_initialized = true ; - } - - // Assigns using a form any expression implicitly convertible to the single argument - // of a T's assignment operator. - // Converting assignments of optional from optional uses this function with - // 'Expr' being of type 'U' and relying on a converting assignment of T from U. - template - void assign_expr_to_initialized ( Expr&& expr, void const* ) - { - assign_value(boost::forward(expr), is_reference_predicate()); - } -#else - // Constructs using any expression implicitly convertible to the single argument - // of a one-argument T constructor. - // Converting constructions of optional from optional uses this function with - // 'Expr' being of type 'U' and relying on a converting constructor of T from U. - template - void construct ( Expr const& expr, void const* ) - { - new (m_storage.address()) internal_type(expr) ; - m_initialized = true ; - } - - // Assigns using a form any expression implicitly convertible to the single argument - // of a T's assignment operator. - // Converting assignments of optional from optional uses this function with - // 'Expr' being of type 'U' and relying on a converting assignment of T from U. - template - void assign_expr_to_initialized ( Expr const& expr, void const* ) - { - assign_value(expr, is_reference_predicate()); - } - -#endif - -#ifdef BOOST_OPTIONAL_WEAK_OVERLOAD_RESOLUTION - // BCB5.64 (and probably lower versions) workaround. - // The in-place factories are supported by means of catch-all constructors - // and assignment operators (the functions are parameterized in terms of - // an arbitrary 'Expr' type) - // This compiler incorrectly resolves the overload set and sinks optional and optional - // to the 'Expr'-taking functions even though explicit overloads are present for them. - // Thus, the following overload is needed to properly handle the case when the 'lhs' - // is another optional. - // - // For VC<=70 compilers this workaround doesn't work because the compiler issues and error - // instead of choosing the wrong overload - // -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - // Notice that 'Expr' will be optional or optional (but not optional_base<..>) - template - void construct ( Expr&& expr, optional_tag const* ) - { - if ( expr.is_initialized() ) - { - // An exception can be thrown here. - // It it happens, THIS will be left uninitialized. - new (m_storage.address()) internal_type(types::move(expr.get())) ; - m_initialized = true ; - } - } -#else - // Notice that 'Expr' will be optional or optional (but not optional_base<..>) - template - void construct ( Expr const& expr, optional_tag const* ) - { - if ( expr.is_initialized() ) - { - // An exception can be thrown here. - // It it happens, THIS will be left uninitialized. - new (m_storage.address()) internal_type(expr.get()) ; - m_initialized = true ; - } - } -#endif -#endif // defined BOOST_OPTIONAL_WEAK_OVERLOAD_RESOLUTION - - void assign_value ( argument_type val, is_not_reference_tag ) { get_impl() = val; } - void assign_value ( argument_type val, is_reference_tag ) { construct(val); } -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - void assign_value ( rval_reference_type val, is_not_reference_tag ) { get_impl() = static_cast(val); } - void assign_value ( rval_reference_type val, is_reference_tag ) { construct( static_cast(val) ); } -#endif - - void destroy() - { - if ( m_initialized ) - destroy_impl(is_reference_predicate()) ; - } - - reference_const_type get_impl() const { return dereference(get_object(), is_reference_predicate() ) ; } - reference_type get_impl() { return dereference(get_object(), is_reference_predicate() ) ; } - - pointer_const_type get_ptr_impl() const { return cast_ptr(get_object(), is_reference_predicate() ) ; } - pointer_type get_ptr_impl() { return cast_ptr(get_object(), is_reference_predicate() ) ; } - - private : - - // internal_type can be either T or reference_content -#if defined(BOOST_OPTIONAL_DETAIL_USE_ATTRIBUTE_MAY_ALIAS) - // This workaround is supposed to silence GCC warnings about broken strict aliasing rules - internal_type const* get_object() const - { - union { void const* ap_pvoid; internal_type const* as_ptype; } caster = { m_storage.address() }; - return caster.as_ptype; - } - internal_type * get_object() - { - union { void* ap_pvoid; internal_type* as_ptype; } caster = { m_storage.address() }; - return caster.as_ptype; - } -#else - internal_type const* get_object() const { return static_cast(m_storage.address()); } - internal_type * get_object() { return static_cast (m_storage.address()); } -#endif - - // reference_content lacks an implicit conversion to T&, so the following is needed to obtain a proper reference. - reference_const_type dereference( internal_type const* p, is_not_reference_tag ) const { return *boost::core::launder(p) ; } - reference_type dereference( internal_type* p, is_not_reference_tag ) { return *boost::core::launder(p) ; } - reference_const_type dereference( internal_type const* p, is_reference_tag ) const { return p->get() ; } - reference_type dereference( internal_type* p, is_reference_tag ) { return p->get() ; } - -#if BOOST_WORKAROUND(BOOST_BORLANDC, BOOST_TESTED_AT(0x581)) - void destroy_impl ( is_not_reference_tag ) { get_ptr_impl()->internal_type::~internal_type() ; m_initialized = false ; } -#else - void destroy_impl ( is_not_reference_tag ) { get_ptr_impl()->~T() ; m_initialized = false ; } -#endif - - void destroy_impl ( is_reference_tag ) { m_initialized = false ; } - - // If T is of reference type, trying to get a pointer to the held value must result in a compile-time error. - // Decent compilers should disallow conversions from reference_content* to T*, but just in case, - // the following overloads are used to filter out the case and guarantee an error in case of T being a reference. - pointer_const_type cast_ptr( internal_type const* p, is_not_reference_tag ) const { return p ; } - pointer_type cast_ptr( internal_type * p, is_not_reference_tag ) { return p ; } - pointer_const_type cast_ptr( internal_type const* p, is_reference_tag ) const { return &p->get() ; } - pointer_type cast_ptr( internal_type * p, is_reference_tag ) { return &p->get() ; } - - bool m_initialized ; - storage_type m_storage ; -} ; - -} // namespace optional_detail - -template -class optional : public optional_detail::optional_base -{ - typedef optional_detail::optional_base base ; - - public : - - typedef optional this_type ; - - typedef BOOST_DEDUCED_TYPENAME base::value_type value_type ; - typedef BOOST_DEDUCED_TYPENAME base::reference_type reference_type ; - typedef BOOST_DEDUCED_TYPENAME base::reference_const_type reference_const_type ; -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - typedef BOOST_DEDUCED_TYPENAME base::rval_reference_type rval_reference_type ; - typedef BOOST_DEDUCED_TYPENAME base::reference_type_of_temporary_wrapper reference_type_of_temporary_wrapper ; -#endif - typedef BOOST_DEDUCED_TYPENAME base::pointer_type pointer_type ; - typedef BOOST_DEDUCED_TYPENAME base::pointer_const_type pointer_const_type ; - typedef BOOST_DEDUCED_TYPENAME base::argument_type argument_type ; - - // Creates an optional uninitialized. - // No-throw - optional() BOOST_NOEXCEPT : base() {} - - // Creates an optional uninitialized. - // No-throw - optional( none_t none_ ) BOOST_NOEXCEPT : base(none_) {} - - // Creates an optional initialized with 'val'. - // Can throw if T::T(T const&) does - optional ( argument_type val ) : base(val) {} - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - // Creates an optional initialized with 'move(val)'. - // Can throw if T::T(T &&) does - optional ( rval_reference_type val ) : base( boost::forward(val) ) - {optional_detail::prevent_binding_rvalue_ref_to_optional_lvalue_ref();} -#endif - - // Creates an optional initialized with 'val' IFF cond is true, otherwise creates an uninitialized optional. - // Can throw if T::T(T const&) does - optional ( bool cond, argument_type val ) : base(cond,val) {} - - // NOTE: MSVC needs templated versions first - - // Creates a deep copy of another convertible optional - // Requires a valid conversion from U to T. - // Can throw if T::T(U const&) does - template - explicit optional ( optional const& rhs ) - : - base() - { - if ( rhs.is_initialized() ) - this->construct(rhs.get()); - } - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - // Creates a deep move of another convertible optional - // Requires a valid conversion from U to T. - // Can throw if T::T(U&&) does - template - explicit optional ( optional && rhs ) - : - base() - { - if ( rhs.is_initialized() ) - this->construct( boost::move(rhs.get()) ); - } -#endif - -#ifndef BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT - // Creates an optional with an expression which can be either - // (a) An instance of InPlaceFactory (i.e. in_place(a,b,...,n); - // (b) An instance of TypedInPlaceFactory ( i.e. in_place(a,b,...,n); - // (c) Any expression implicitly convertible to the single type - // of a one-argument T's constructor. - // (d*) Weak compilers (BCB) might also resolved Expr as optional and optional - // even though explicit overloads are present for these. - // Depending on the above some T ctor is called. - // Can throw if the resolved T ctor throws. -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - - - template - explicit optional ( Expr&& expr, - BOOST_DEDUCED_TYPENAME boost::disable_if_c< - (boost::is_base_of::type>::value) || - boost::is_same::type, none_t>::value, bool >::type = true - ) - : base(boost::forward(expr),boost::addressof(expr)) - {optional_detail::prevent_binding_rvalue_ref_to_optional_lvalue_ref();} - -#else - template - explicit optional ( Expr const& expr ) : base(expr,boost::addressof(expr)) {} -#endif // !defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES -#endif // !defined BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT - - // Creates a deep copy of another optional - // Can throw if T::T(T const&) does - optional ( optional const& rhs ) : base( static_cast(rhs) ) {} - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - // Creates a deep move of another optional - // Can throw if T::T(T&&) does - optional ( optional && rhs ) - BOOST_NOEXCEPT_IF(::boost::is_nothrow_move_constructible::value) - : base( boost::move(rhs) ) - {} - -#endif - // No-throw (assuming T::~T() doesn't) - ~optional() {} - -#if !defined(BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT) && !defined(BOOST_OPTIONAL_WEAK_OVERLOAD_RESOLUTION) - // Assigns from an expression. See corresponding constructor. - // Basic Guarantee: If the resolved T ctor throws, this is left UNINITIALIZED -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - - template - BOOST_DEDUCED_TYPENAME boost::disable_if_c< - boost::is_base_of::type>::value || - boost::is_same::type, none_t>::value, - optional& - >::type - operator= ( Expr&& expr ) - { - optional_detail::prevent_binding_rvalue_ref_to_optional_lvalue_ref(); - this->assign_expr(boost::forward(expr),boost::addressof(expr)); - return *this ; - } - -#else - template - optional& operator= ( Expr const& expr ) - { - this->assign_expr(expr,boost::addressof(expr)); - return *this ; - } -#endif // !defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES -#endif // !defined(BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT) && !defined(BOOST_OPTIONAL_WEAK_OVERLOAD_RESOLUTION) - - // Copy-assigns from another convertible optional (converts && deep-copies the rhs value) - // Requires a valid conversion from U to T. - // Basic Guarantee: If T::T( U const& ) throws, this is left UNINITIALIZED - template - optional& operator= ( optional const& rhs ) - { - this->assign(rhs); - return *this ; - } - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - // Move-assigns from another convertible optional (converts && deep-moves the rhs value) - // Requires a valid conversion from U to T. - // Basic Guarantee: If T::T( U && ) throws, this is left UNINITIALIZED - template - optional& operator= ( optional && rhs ) - { - this->assign(boost::move(rhs)); - return *this ; - } -#endif - - // Assigns from another optional (deep-copies the rhs value) - // Basic Guarantee: If T::T( T const& ) throws, this is left UNINITIALIZED - // (NOTE: On BCB, this operator is not actually called and left is left UNMODIFIED in case of a throw) - optional& operator= ( optional const& rhs ) - { - this->assign( static_cast(rhs) ) ; - return *this ; - } - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - // Assigns from another optional (deep-moves the rhs value) - optional& operator= ( optional && rhs ) - BOOST_NOEXCEPT_IF(::boost::is_nothrow_move_constructible::value && ::boost::is_nothrow_move_assignable::value) - { - this->assign( static_cast(rhs) ) ; - return *this ; - } -#endif - - // Assigns from a T (deep-copies the rhs value) - // Basic Guarantee: If T::( T const& ) throws, this is left UNINITIALIZED - optional& operator= ( argument_type val ) - { - this->assign( val ) ; - return *this ; - } - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - // Assigns from a T (deep-moves the rhs value) - optional& operator= ( rval_reference_type val ) - { - optional_detail::prevent_binding_rvalue_ref_to_optional_lvalue_ref(); - this->assign( boost::move(val) ) ; - return *this ; - } -#endif - - // Assigns from a "none" - // Which destroys the current value, if any, leaving this UNINITIALIZED - // No-throw (assuming T::~T() doesn't) - optional& operator= ( none_t none_ ) BOOST_NOEXCEPT - { - this->assign( none_ ) ; - return *this ; - } - -#if (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) && (!defined BOOST_NO_CXX11_VARIADIC_TEMPLATES) - // Constructs in-place - // upon exception *this is always uninitialized - template - void emplace ( Args&&... args ) - { - this->emplace_assign( boost::forward(args)... ); - } -#elif (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) - template - void emplace ( Arg&& arg ) - { - this->emplace_assign( boost::forward(arg) ); - } - - void emplace () - { - this->emplace_assign(); - } -#else - template - void emplace ( const Arg& arg ) - { - this->emplace_assign( arg ); - } - - template - void emplace ( Arg& arg ) - { - this->emplace_assign( arg ); - } - - void emplace () - { - this->emplace_assign(); - } -#endif - - void swap( optional & arg ) - BOOST_NOEXCEPT_IF(::boost::is_nothrow_move_constructible::value && ::boost::is_nothrow_move_assignable::value) - { - // allow for Koenig lookup - boost::core::invoke_swap(*this, arg); - } - - - // Returns a reference to the value if this is initialized, otherwise, - // the behaviour is UNDEFINED - // No-throw - reference_const_type get() const { BOOST_ASSERT(this->is_initialized()) ; return this->get_impl(); } - reference_type get() { BOOST_ASSERT(this->is_initialized()) ; return this->get_impl(); } - - // Returns a copy of the value if this is initialized, 'v' otherwise - reference_const_type get_value_or ( reference_const_type v ) const { return this->is_initialized() ? get() : v ; } - reference_type get_value_or ( reference_type v ) { return this->is_initialized() ? get() : v ; } - - // Returns a pointer to the value if this is initialized, otherwise, - // the behaviour is UNDEFINED - // No-throw - pointer_const_type operator->() const { BOOST_ASSERT(this->is_initialized()) ; return this->get_ptr_impl() ; } - pointer_type operator->() { BOOST_ASSERT(this->is_initialized()) ; return this->get_ptr_impl() ; } - - // Returns a reference to the value if this is initialized, otherwise, - // the behaviour is UNDEFINED - // No-throw -#if (!defined BOOST_NO_CXX11_REF_QUALIFIERS) && (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) - reference_const_type operator *() const& { return this->get() ; } - reference_type operator *() & { return this->get() ; } - reference_type_of_temporary_wrapper operator *() && { return base::types::move(this->get()) ; } -#else - reference_const_type operator *() const { return this->get() ; } - reference_type operator *() { return this->get() ; } -#endif // !defined BOOST_NO_CXX11_REF_QUALIFIERS - -#if (!defined BOOST_NO_CXX11_REF_QUALIFIERS) && (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) - reference_const_type value() const& - { - if (this->is_initialized()) - return this->get() ; - else - throw_exception(bad_optional_access()); - } - - reference_type value() & - { - if (this->is_initialized()) - return this->get() ; - else - throw_exception(bad_optional_access()); - } - - reference_type_of_temporary_wrapper value() && - { - if (this->is_initialized()) - return base::types::move(this->get()) ; - else - throw_exception(bad_optional_access()); - } - -#else - reference_const_type value() const - { - if (this->is_initialized()) - return this->get() ; - else - throw_exception(bad_optional_access()); - } - - reference_type value() - { - if (this->is_initialized()) - return this->get() ; - else - throw_exception(bad_optional_access()); - } -#endif - - -#ifndef BOOST_NO_CXX11_REF_QUALIFIERS - template - value_type value_or ( U&& v ) const& - { - if (this->is_initialized()) - return get(); - else - return boost::forward(v); - } - - template - value_type value_or ( U&& v ) && - { - if (this->is_initialized()) - return base::types::move(get()); - else - return boost::forward(v); - } -#elif !defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - template - value_type value_or ( U&& v ) const - { - if (this->is_initialized()) - return get(); - else - return boost::forward(v); - } -#else - template - value_type value_or ( U const& v ) const - { - if (this->is_initialized()) - return get(); - else - return v; - } - - template - value_type value_or ( U& v ) const - { - if (this->is_initialized()) - return get(); - else - return v; - } -#endif - - -#ifndef BOOST_NO_CXX11_REF_QUALIFIERS - template - value_type value_or_eval ( F f ) const& - { - if (this->is_initialized()) - return get(); - else - return f(); - } - - template - value_type value_or_eval ( F f ) && - { - if (this->is_initialized()) - return base::types::move(get()); - else - return f(); - } -#else - template - value_type value_or_eval ( F f ) const - { - if (this->is_initialized()) - return get(); - else - return f(); - } -#endif - - bool operator!() const BOOST_NOEXCEPT { return !this->is_initialized() ; } - - BOOST_EXPLICIT_OPERATOR_BOOL_NOEXCEPT() -} ; - -} // namespace boost - - -#endif // header guard diff --git a/include/boost/optional/detail/optional_aligned_storage.hpp b/include/boost/optional/detail/optional_aligned_storage.hpp index fa8e6380..6f27e174 100644 --- a/include/boost/optional/detail/optional_aligned_storage.hpp +++ b/include/boost/optional/detail/optional_aligned_storage.hpp @@ -60,8 +60,13 @@ class aligned_storage T * ptr_ref() { return static_cast (address()); } #endif +#ifndef BOOST_MSVC // workaround for MSVC 14.1 compiler crash T const& ref() const { return *boost::core::launder(ptr_ref()); } T & ref() { return *boost::core::launder(ptr_ref()); } +#else + T const& ref() const { return *ptr_ref(); } + T & ref() { return *ptr_ref(); } +#endif } ; From 790d4f729fb8f64d1fd31207c93b81f4be221753 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 4 Jan 2024 02:03:33 +0100 Subject: [PATCH 098/163] cleaner workaround for VS2017 launder bug --- .../boost/optional/detail/optional_aligned_storage.hpp | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/include/boost/optional/detail/optional_aligned_storage.hpp b/include/boost/optional/detail/optional_aligned_storage.hpp index 6f27e174..147c614e 100644 --- a/include/boost/optional/detail/optional_aligned_storage.hpp +++ b/include/boost/optional/detail/optional_aligned_storage.hpp @@ -60,12 +60,14 @@ class aligned_storage T * ptr_ref() { return static_cast (address()); } #endif -#ifndef BOOST_MSVC // workaround for MSVC 14.1 compiler crash - T const& ref() const { return *boost::core::launder(ptr_ref()); } - T & ref() { return *boost::core::launder(ptr_ref()); } -#else +#if BOOST_WORKAROUND(BOOST_MSVC, < 1920) + // workaround for VS2017 (32 bit) compiler crash + // toolset=msvc-14.1 cxxstd=17 variant=release address-model=32 T const& ref() const { return *ptr_ref(); } T & ref() { return *ptr_ref(); } +#else + T const& ref() const { return *boost::core::launder(ptr_ref()); } + T & ref() { return *boost::core::launder(ptr_ref()); } #endif } ; From b270cf019b9f3bf6e8f76980606a30314ea20baf Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 4 Jan 2024 08:29:06 +0100 Subject: [PATCH 099/163] revert launder fix A better fix is now in boost::launder. --- .../boost/optional/detail/optional_aligned_storage.hpp | 8 -------- 1 file changed, 8 deletions(-) diff --git a/include/boost/optional/detail/optional_aligned_storage.hpp b/include/boost/optional/detail/optional_aligned_storage.hpp index 147c614e..704cadb6 100644 --- a/include/boost/optional/detail/optional_aligned_storage.hpp +++ b/include/boost/optional/detail/optional_aligned_storage.hpp @@ -60,16 +60,8 @@ class aligned_storage T * ptr_ref() { return static_cast (address()); } #endif -#if BOOST_WORKAROUND(BOOST_MSVC, < 1920) - // workaround for VS2017 (32 bit) compiler crash - // toolset=msvc-14.1 cxxstd=17 variant=release address-model=32 - T const& ref() const { return *ptr_ref(); } - T & ref() { return *ptr_ref(); } -#else T const& ref() const { return *boost::core::launder(ptr_ref()); } T & ref() { return *boost::core::launder(ptr_ref()); } -#endif - } ; } // namespace optional_detail From 5c34c54b05923ee9bba9957f2fa68a9027fe628e Mon Sep 17 00:00:00 2001 From: Peter Dimov Date: Mon, 15 Jan 2024 20:05:07 +0200 Subject: [PATCH 100/163] Update ci.yml --- .github/workflows/ci.yml | 912 ++++++++++++++++++++++++--------------- 1 file changed, 567 insertions(+), 345 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 1826a08d..279a7100 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -1,4 +1,4 @@ -name: GitHub Actions CI +name: CI on: pull_request: @@ -6,17 +6,10 @@ on: branches: - master - develop - - githubactions* - feature/** - - fix/** - - pr/** - -concurrency: - group: ${{format('{0}:{1}', github.repository, github.ref)}} - cancel-in-progress: true env: - NET_RETRY_COUNT: 5 + UBSAN_OPTIONS: print_stacktrace=1 jobs: posix: @@ -24,373 +17,602 @@ jobs: fail-fast: false matrix: include: - - name: "TOOLSET=gcc COMPILER=g++ CXXSTD=03,11 Job 0" - buildtype: "boost" - packages: "" - packages_to_remove: "" - os: "ubuntu-20.04" - container: "ubuntu:16.04" - cxx: "g++" - sources: "" - llvm_os: "" - llvm_ver: "" - toolset: "gcc" - compiler: "g++" - cxxstd: "03,11" - - name: "TOOLSET=gcc COMPILER=g++-4.7 CXXSTD=03,11 Job 1" - buildtype: "boost" - packages: "g++-4.7" - packages_to_remove: "" - os: "ubuntu-20.04" - container: "ubuntu:16.04" - cxx: "g++-4.7" - sources: "" - llvm_os: "" - llvm_ver: "" - toolset: "gcc" - compiler: "g++-4.7" - cxxstd: "03,11" - - name: "TOOLSET=gcc COMPILER=g++-4.8 CXXSTD=03,11 Job 2" - buildtype: "boost" - packages: "g++-4.8" - packages_to_remove: "" - os: "ubuntu-20.04" - container: "ubuntu:16.04" - cxx: "g++-4.8" - sources: "" - llvm_os: "" - llvm_ver: "" - toolset: "gcc" - compiler: "g++-4.8" + - toolset: gcc-4.8 cxxstd: "03,11" - - name: "TOOLSET=gcc COMPILER=g++-4.9 CXXSTD=03,11 Job 3" - buildtype: "boost" - packages: "g++-4.9" - packages_to_remove: "" - os: "ubuntu-20.04" - container: "ubuntu:16.04" - cxx: "g++-4.9" - sources: "" - llvm_os: "" - llvm_ver: "" - toolset: "gcc" - compiler: "g++-4.9" - cxxstd: "03,11" - - name: "TOOLSET=gcc COMPILER=g++-5 CXXSTD=03,11,14,1z Job 4" - buildtype: "boost" - packages: "g++-5" - packages_to_remove: "" - os: "ubuntu-20.04" - container: "ubuntu:16.04" - cxx: "g++-5" - sources: "" - llvm_os: "" - llvm_ver: "" - toolset: "gcc" - compiler: "g++-5" + os: ubuntu-latest + container: ubuntu:18.04 + install: g++-4.8-multilib + address-model: 32,64 + - toolset: gcc-5 cxxstd: "03,11,14,1z" - - name: "TOOLSET=gcc COMPILER=g++-6 CXXSTD=03,11,14,1z Job 5" - buildtype: "boost" - packages: "g++-6" - packages_to_remove: "" - os: "ubuntu-20.04" - container: "ubuntu:16.04" - cxx: "g++-6" - sources: "" - llvm_os: "" - llvm_ver: "" - toolset: "gcc" - compiler: "g++-6" + os: ubuntu-latest + container: ubuntu:18.04 + install: g++-5-multilib + address-model: 32,64 + - toolset: gcc-6 cxxstd: "03,11,14,1z" - - name: "TOOLSET=gcc COMPILER=g++-7 CXXSTD=03,11,14,17 Job 6" - buildtype: "boost" - packages: "g++-7" - packages_to_remove: "" - os: "ubuntu-20.04" - container: "ubuntu:16.04" - cxx: "g++-7" - sources: "" - llvm_os: "" - llvm_ver: "" - toolset: "gcc" - compiler: "g++-7" + os: ubuntu-latest + container: ubuntu:18.04 + install: g++-6-multilib + address-model: 32,64 + - toolset: gcc-7 cxxstd: "03,11,14,17" - - name: "TOOLSET=clang COMPILER=clang++ CXXSTD=03,11 Job 7" - buildtype: "boost" - packages: "clang" - packages_to_remove: "" - os: "ubuntu-22.04" - container: "ubuntu:18.04" - cxx: "clang++" - sources: "" - llvm_os: "" - llvm_ver: "" - toolset: "clang" - compiler: "clang++" - cxxstd: "03,11" - - name: "TOOLSET=clang COMPILER=clang++-3.5 CXXSTD=03, Job 8" - buildtype: "boost" - packages: "clang-3.5 libstdc++-4.9-dev" - packages_to_remove: "" - os: "ubuntu-20.04" - container: "ubuntu:16.04" - cxx: "clang++-3.5" - sources: "" - llvm_os: "precise" - llvm_ver: "3.5" - toolset: "clang" - compiler: "clang++-3.5" - cxxstd: "03,11,14" - - name: "TOOLSET=clang COMPILER=clang++-3.6 CXXSTD=03, Job 9" - buildtype: "boost" - packages: "clang-3.6" - packages_to_remove: "" - os: "ubuntu-20.04" - container: "ubuntu:16.04" - cxx: "clang++-3.6" - sources: "" - llvm_os: "precise" - llvm_ver: "3.6" - toolset: "clang" - compiler: "clang++-3.6" - cxxstd: "03,11,14" - - name: "TOOLSET=clang COMPILER=clang++-3.7 CXXSTD=03, Job 10" - buildtype: "boost" - packages: "clang-3.7" - packages_to_remove: "" - os: "ubuntu-20.04" - container: "ubuntu:16.04" - cxx: "clang++-3.7" - sources: "" - llvm_os: "precise" - llvm_ver: "3.7" - toolset: "clang" - compiler: "clang++-3.7" - cxxstd: "03,11,14" - - name: "TOOLSET=clang COMPILER=clang++-3.8 CXXSTD=03, Job 11" - buildtype: "boost" - packages: "clang-3.8 libstdc++-4.9-dev" - packages_to_remove: "" - os: "ubuntu-20.04" - container: "ubuntu:16.04" - cxx: "clang++-3.8" - sources: "" - llvm_os: "precise" - llvm_ver: "3.8" - toolset: "clang" - compiler: "clang++-3.8" - cxxstd: "03,11,14" - - name: "TOOLSET=clang COMPILER=clang++-3.9 CXXSTD=03, Job 12" - buildtype: "boost" - packages: "clang-3.9 libstdc++-4.9-dev" - packages_to_remove: "" - os: "ubuntu-20.04" - container: "ubuntu:16.04" - cxx: "clang++-3.9" - sources: "" - llvm_os: "precise" - llvm_ver: "3.9" - toolset: "clang" - compiler: "clang++-3.9" + os: ubuntu-latest + container: ubuntu:18.04 + install: g++-7-multilib + address-model: 32,64 + - toolset: gcc-8 + cxxstd: "03,11,14,17,2a" + os: ubuntu-20.04 + install: g++-8-multilib + address-model: 32,64 + - toolset: gcc-9 + cxxstd: "03,11,14,17,2a" + os: ubuntu-20.04 + install: g++-9-multilib + address-model: 32,64 + - toolset: gcc-10 + cxxstd: "03,11,14,17,2a" + os: ubuntu-20.04 + install: g++-10-multilib + address-model: 32,64 + - toolset: gcc-11 + cxxstd: "03,11,14,17,20" + os: ubuntu-20.04 + install: g++-11-multilib + address-model: 32,64 + - toolset: gcc-12 + cxxstd: "03,11,14,17,20,2b" + os: ubuntu-22.04 + install: g++-12-multilib + address-model: 32,64 + - toolset: gcc-13 + cxxstd: "03,11,14,17,20,2b" + os: ubuntu-latest + container: ubuntu:23.04 + install: g++-13-multilib + address-model: 32,64 + - toolset: clang + compiler: clang++-3.9 cxxstd: "03,11,14" - - name: "TOOLSET=clang COMPILER=clang++-4.0 CXXSTD=03, Job 13" - buildtype: "boost" - packages: "clang-4.0" - packages_to_remove: "" - os: "ubuntu-20.04" - container: "ubuntu:14.04" - cxx: "clang++-4.0" - sources: "" - llvm_os: "trusty" - llvm_ver: "4.0" - toolset: "clang" - compiler: "clang++-4.0" + os: ubuntu-latest + container: ubuntu:18.04 + install: clang-3.9 + - toolset: clang + compiler: clang++-4.0 cxxstd: "03,11,14" - - name: "TOOLSET=clang COMPILER=clang++-5.0 CXXSTD=03, Job 14" - buildtype: "boost" - packages: "clang-5.0" - packages_to_remove: "" - os: "ubuntu-22.04" - container: "ubuntu:18.04" - cxx: "clang++-5.0" - sources: "" - llvm_os: "" - llvm_ver: "" - toolset: "clang" - compiler: "clang++-5.0" + os: ubuntu-latest + container: ubuntu:18.04 + install: clang-4.0 + - toolset: clang + compiler: clang++-5.0 cxxstd: "03,11,14,1z" + os: ubuntu-latest + container: ubuntu:18.04 + install: clang-5.0 + - toolset: clang + compiler: clang++-6.0 + cxxstd: "03,11,14,17" + os: ubuntu-20.04 + install: clang-6.0 + - toolset: clang + compiler: clang++-7 + cxxstd: "03,11,14,17" + os: ubuntu-20.04 + install: clang-7 + - toolset: clang + compiler: clang++-8 + cxxstd: "03,11,14,17" + os: ubuntu-20.04 + install: clang-8 + - toolset: clang + compiler: clang++-9 + cxxstd: "03,11,14,17,2a" + os: ubuntu-20.04 + install: clang-9 + - toolset: clang + compiler: clang++-10 + cxxstd: "03,11,14,17,2a" + os: ubuntu-20.04 + - toolset: clang + compiler: clang++-11 + cxxstd: "03,11,14,17,2a" + os: ubuntu-20.04 + - toolset: clang + compiler: clang++-12 + cxxstd: "03,11,14,17,20" + os: ubuntu-20.04 + - toolset: clang + compiler: clang++-13 + cxxstd: "03,11,14,17,20,2b" + container: ubuntu:22.04 + os: ubuntu-latest + install: clang-13 + - toolset: clang + compiler: clang++-14 + cxxstd: "03,11,14,17,20,2b" + container: ubuntu:22.04 + os: ubuntu-latest + install: clang-14 + - toolset: clang + compiler: clang++-15 + cxxstd: "03,11,14,17,20,2b" + container: ubuntu:22.04 + os: ubuntu-latest + install: clang-15 + - toolset: clang + compiler: clang++-16 + cxxstd: "03,11,14,17,20,2b" + container: ubuntu:23.04 + os: ubuntu-latest + install: clang-16 + - toolset: clang + compiler: clang++-17 + cxxstd: "03,11,14,17,20,2b" + container: ubuntu:23.10 + os: ubuntu-latest + install: clang-17 + - toolset: clang + cxxstd: "03,11,14,17,2a" + os: macos-11 + - toolset: clang + cxxstd: "03,11,14,17,20,2b" + os: macos-12 + - toolset: clang + cxxstd: "03,11,14,17,20,2b" + os: macos-13 - runs-on: ${{ matrix.os }} - container: ${{ matrix.container }} + runs-on: ${{matrix.os}} + container: ${{matrix.container}} - steps: - - name: Check if running in container - if: matrix.container != '' - run: echo "GHA_CONTAINER=${{ matrix.container }}" >> $GITHUB_ENV - - name: If running in container, upgrade packages - if: matrix.container != '' - run: | - if [ -f "/etc/debian_version" ]; then - echo "DEBIAN_FRONTEND=noninteractive" >> $GITHUB_ENV - export DEBIAN_FRONTEND=noninteractive - apt-get -o Acquire::Retries=$NET_RETRY_COUNT update - apt-get -o Acquire::Retries=$NET_RETRY_COUNT install -y sudo software-properties-common curl wget apt-transport-https ca-certificates - # Need (newer) git, and the older Ubuntu container may require requesting the key manually using port 80 - curl -sSL --retry ${NET_RETRY_COUNT:-5} 'http://keyserver.ubuntu.com/pks/lookup?op=get&search=0xE1DD270288B4E6030699E45FA1715D88E1DF1F24' | sudo gpg --dearmor > /etc/apt/trusted.gpg.d/git-core_ubuntu_ppa.gpg - for i in {1..${NET_RETRY_COUNT:-3}}; do sudo -E add-apt-repository -y ppa:git-core/ppa && break || sleep 10; done - apt-get -o Acquire::Retries=$NET_RETRY_COUNT update - apt-get -o Acquire::Retries=$NET_RETRY_COUNT install -y g++ python libpython-dev git unzip libssl-dev build-essential libc++-helpers gcc-multilib g++-multilib pkgconf ccache - fi - - - uses: actions/checkout@v2 - - - name: linux + defaults: + run: shell: bash - env: - CXX: ${{ matrix.cxx }} - SOURCES: ${{ matrix.sources }} - LLVM_OS: ${{ matrix.llvm_os }} - LLVM_VER: ${{ matrix.llvm_ver }} - PACKAGES: ${{ matrix.packages }} - PACKAGES_TO_REMOVE: ${{ matrix.packages_to_remove }} - JOB_BUILDTYPE: ${{ matrix.buildtype }} - TOOLSET: ${{ matrix.toolset }} - COMPILER: ${{ matrix.compiler }} - CXXSTD: ${{ matrix.cxxstd }} - TRAVIS_BRANCH: ${{ github.base_ref }} - TRAVIS_OS_NAME: "linux" - run: | - echo '==================================> SETUP' - echo '==================================> PACKAGES' - set -e - if [ -n "$PACKAGES_TO_REMOVE" ]; then sudo apt-get purge -y $PACKAGES_TO_REMOVE; fi - echo ">>>>> APT: REPO.." - for i in {1..3}; do sudo -E apt-add-repository -y "ppa:ubuntu-toolchain-r/test" && break || sleep 2; done - - if test -n "${LLVM_OS}" ; then - wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add - - if test -n "${LLVM_VER}" ; then - sudo -E apt-add-repository "deb http://apt.llvm.org/${LLVM_OS}/ llvm-toolchain-${LLVM_OS}-${LLVM_VER} main" - else - # Snapshot (i.e. trunk) build of clang - sudo -E apt-add-repository "deb http://apt.llvm.org/${LLVM_OS}/ llvm-toolchain-${LLVM_OS} main" - fi - fi - echo ">>>>> APT: UPDATE.." - sudo -E apt-get -o Acquire::Retries=3 update - if test -n "${SOURCES}" ; then - echo ">>>>> APT: INSTALL SOURCES.." - for SOURCE in $SOURCES; do - sudo -E apt-add-repository ppa:$SOURCE - done - fi - echo ">>>>> APT: INSTALL ${PACKAGES}.." - sudo -E DEBIAN_FRONTEND=noninteractive apt-get -o Acquire::Retries=3 -y --no-install-suggests --no-install-recommends install ${PACKAGES} - - echo '==================================> INSTALL AND COMPILE' - set -e - export TRAVIS_BUILD_DIR=$(pwd) - export TRAVIS_BRANCH=${TRAVIS_BRANCH:-$(echo $GITHUB_REF | awk 'BEGIN { FS = "/" } ; { print $3 }')} - export VCS_COMMIT_ID=$GITHUB_SHA - export GIT_COMMIT=$GITHUB_SHA - export REPO_NAME=$(basename $GITHUB_REPOSITORY) - export USER=$(whoami) - export CC=${CC:-gcc} - export PATH=~/.local/bin:/usr/local/bin:$PATH - - if [ "$JOB_BUILDTYPE" == "boost" ]; then - - echo '==================================> INSTALL' - - BOOST_BRANCH=develop && [ "$TRAVIS_BRANCH" == "master" ] && BOOST_BRANCH=master || true + + steps: + - uses: actions/checkout@v3 + + - name: Setup container environment + if: matrix.container + run: | + apt-get update + apt-get -y install sudo python3 git g++ + + - name: Install packages + if: matrix.install + run: | + sudo apt-get update + sudo apt-get -y install ${{matrix.install}} + + - name: Setup Boost + run: | + echo GITHUB_REPOSITORY: $GITHUB_REPOSITORY + LIBRARY=${GITHUB_REPOSITORY#*/} + echo LIBRARY: $LIBRARY + echo "LIBRARY=$LIBRARY" >> $GITHUB_ENV + echo GITHUB_BASE_REF: $GITHUB_BASE_REF + echo GITHUB_REF: $GITHUB_REF + REF=${GITHUB_BASE_REF:-$GITHUB_REF} + REF=${REF#refs/heads/} + echo REF: $REF + BOOST_BRANCH=develop && [ "$REF" == "master" ] && BOOST_BRANCH=master || true + echo BOOST_BRANCH: $BOOST_BRANCH cd .. git clone -b $BOOST_BRANCH --depth 1 https://github.com/boostorg/boost.git boost-root cd boost-root - git submodule update --init tools/build - git submodule update --init libs/config + cp -r $GITHUB_WORKSPACE/* libs/$LIBRARY git submodule update --init tools/boostdep - cp -r $TRAVIS_BUILD_DIR/* libs/optional - python tools/boostdep/depinst/depinst.py optional + python3 tools/boostdep/depinst/depinst.py --git_args "--jobs 3" $LIBRARY ./bootstrap.sh - ./b2 headers + ./b2 -d0 headers - echo '==================================> SCRIPT' + - name: Create user-config.jam + if: matrix.compiler + run: | + echo "using ${{matrix.toolset}} : : ${{matrix.compiler}} ;" > ~/user-config.jam - echo "using $TOOLSET : : $COMPILER ;" > ~/user-config.jam - ./b2 libs/optional/test toolset=$TOOLSET cxxstd=$CXXSTD + - name: Run tests + run: | + cd ../boost-root + ./b2 -j3 libs/$LIBRARY/test toolset=${{matrix.toolset}} cxxstd=${{matrix.cxxstd}} ${ADDRMD:+address-model=$ADDRMD} variant=debug,release - fi - osx: + windows: strategy: fail-fast: false matrix: include: - - name: "TOOLSET=clang COMPILER=clang++ CXXSTD=03,11,1 Job 15" - buildtype: "boost" - packages: "" - os: "macos-11" - cxx: "clang++" - sources: "" - llvm_os: "" - llvm_ver: "" - toolset: "clang" - compiler: "clang++" + - toolset: msvc-14.0 + cxxstd: 14,latest + addrmd: 32,64 + os: windows-2019 + - toolset: msvc-14.2 + cxxstd: "14,17,20,latest" + addrmd: 32,64 + os: windows-2019 + - toolset: msvc-14.3 + cxxstd: "14,17,20,latest" + addrmd: 32,64 + os: windows-2022 + - toolset: clang-win + cxxstd: "14,17,20,latest" + addrmd: 32,64 + os: windows-2022 + - toolset: gcc cxxstd: "03,11,14,17,2a" + addrmd: 64 + os: windows-2019 - runs-on: ${{ matrix.os }} + runs-on: ${{matrix.os}} steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v3 - - name: "osx" - shell: bash - env: - CXX: ${{ matrix.cxx }} - SOURCES: ${{ matrix.sources }} - LLVM_OS: ${{ matrix.llvm_os }} - LLVM_VER: ${{ matrix.llvm_ver }} - PACKAGES: ${{ matrix.packages }} - JOB_BUILDTYPE: ${{ matrix.buildtype }} - TOOLSET: ${{ matrix.toolset }} - COMPILER: ${{ matrix.compiler }} - CXXSTD: ${{ matrix.cxxstd }} - TRAVIS_BRANCH: ${{ github.base_ref }} - TRAVIS_OS_NAME: "osx" - run: | - echo '==================================> SETUP' - set -e - sudo mv /Library/Developer/CommandLineTools /Library/Developer/CommandLineTools.bck - echo '==================================> PACKAGES' - echo '==================================> INSTALL AND COMPILE' - set -e - export TRAVIS_BUILD_DIR=$(pwd) - export TRAVIS_BRANCH=${TRAVIS_BRANCH:-$(echo $GITHUB_REF | awk 'BEGIN { FS = "/" } ; { print $3 }')} - export VCS_COMMIT_ID=$GITHUB_SHA - export GIT_COMMIT=$GITHUB_SHA - export REPO_NAME=$(basename $GITHUB_REPOSITORY) - export USER=$(whoami) - export CC=${CC:-gcc} - export PATH=~/.local/bin:/usr/local/bin:$PATH - - if [ "$JOB_BUILDTYPE" == "boost" ]; then - - echo '==================================> INSTALL' - - BOOST_BRANCH=develop && [ "$TRAVIS_BRANCH" == "master" ] && BOOST_BRANCH=master || true + - name: Setup Boost + shell: cmd + run: | + echo GITHUB_REPOSITORY: %GITHUB_REPOSITORY% + for /f %%i in ("%GITHUB_REPOSITORY%") do set LIBRARY=%%~nxi + echo LIBRARY: %LIBRARY% + echo LIBRARY=%LIBRARY%>>%GITHUB_ENV% + echo GITHUB_BASE_REF: %GITHUB_BASE_REF% + echo GITHUB_REF: %GITHUB_REF% + if "%GITHUB_BASE_REF%" == "" set GITHUB_BASE_REF=%GITHUB_REF% + set BOOST_BRANCH=develop + for /f %%i in ("%GITHUB_BASE_REF%") do if "%%~nxi" == "master" set BOOST_BRANCH=master + echo BOOST_BRANCH: %BOOST_BRANCH% + cd .. + git clone -b %BOOST_BRANCH% --depth 1 https://github.com/boostorg/boost.git boost-root + cd boost-root + xcopy /s /e /q %GITHUB_WORKSPACE% libs\%LIBRARY%\ + git submodule update --init tools/boostdep + python tools/boostdep/depinst/depinst.py --git_args "--jobs 3" %LIBRARY% + cmd /c bootstrap + b2 -d0 headers + + - name: Run tests + shell: cmd + run: | + cd ../boost-root + b2 -j3 libs/%LIBRARY%/test toolset=${{matrix.toolset}} cxxstd=${{matrix.cxxstd}} address-model=${{matrix.addrmd}} variant=debug,release embed-manifest-via=linker + + posix-cmake-subdir: + strategy: + fail-fast: false + matrix: + include: + - os: ubuntu-20.04 + - os: ubuntu-22.04 + - os: macos-11 + - os: macos-12 + - os: macos-13 + + runs-on: ${{matrix.os}} + + steps: + - uses: actions/checkout@v3 + + - name: Install packages + if: matrix.install + run: sudo apt-get -y install ${{matrix.install}} + + - name: Setup Boost + run: | + echo GITHUB_REPOSITORY: $GITHUB_REPOSITORY + LIBRARY=${GITHUB_REPOSITORY#*/} + echo LIBRARY: $LIBRARY + echo "LIBRARY=$LIBRARY" >> $GITHUB_ENV + echo GITHUB_BASE_REF: $GITHUB_BASE_REF + echo GITHUB_REF: $GITHUB_REF + REF=${GITHUB_BASE_REF:-$GITHUB_REF} + REF=${REF#refs/heads/} + echo REF: $REF + BOOST_BRANCH=develop && [ "$REF" == "master" ] && BOOST_BRANCH=master || true + echo BOOST_BRANCH: $BOOST_BRANCH cd .. git clone -b $BOOST_BRANCH --depth 1 https://github.com/boostorg/boost.git boost-root cd boost-root - git submodule update --init tools/build - git submodule update --init libs/config + cp -r $GITHUB_WORKSPACE/* libs/$LIBRARY git submodule update --init tools/boostdep - cp -r $TRAVIS_BUILD_DIR/* libs/optional - python tools/boostdep/depinst/depinst.py optional - ./bootstrap.sh - ./b2 headers + python tools/boostdep/depinst/depinst.py --git_args "--jobs 3" $LIBRARY + + - name: Use library with add_subdirectory + run: | + cd ../boost-root/libs/$LIBRARY/test/cmake_subdir_test + mkdir __build__ && cd __build__ + cmake .. + cmake --build . + ctest --output-on-failure --no-tests=error + + posix-cmake-install: + strategy: + fail-fast: false + matrix: + include: + - os: ubuntu-20.04 + - os: ubuntu-22.04 + - os: macos-11 + - os: macos-12 + - os: macos-13 + + runs-on: ${{matrix.os}} + + steps: + - uses: actions/checkout@v3 + + - name: Install packages + if: matrix.install + run: sudo apt-get -y install ${{matrix.install}} + + - name: Setup Boost + run: | + echo GITHUB_REPOSITORY: $GITHUB_REPOSITORY + LIBRARY=${GITHUB_REPOSITORY#*/} + echo LIBRARY: $LIBRARY + echo "LIBRARY=$LIBRARY" >> $GITHUB_ENV + echo GITHUB_BASE_REF: $GITHUB_BASE_REF + echo GITHUB_REF: $GITHUB_REF + REF=${GITHUB_BASE_REF:-$GITHUB_REF} + REF=${REF#refs/heads/} + echo REF: $REF + BOOST_BRANCH=develop && [ "$REF" == "master" ] && BOOST_BRANCH=master || true + echo BOOST_BRANCH: $BOOST_BRANCH + cd .. + git clone -b $BOOST_BRANCH --depth 1 https://github.com/boostorg/boost.git boost-root + cd boost-root + cp -r $GITHUB_WORKSPACE/* libs/$LIBRARY + git submodule update --init tools/boostdep + python tools/boostdep/depinst/depinst.py --git_args "--jobs 3" $LIBRARY - echo '==================================> SCRIPT' + - name: Configure + run: | + cd ../boost-root + mkdir __build__ && cd __build__ + cmake -DBOOST_INCLUDE_LIBRARIES=$LIBRARY -DCMAKE_INSTALL_PREFIX=~/.local .. - echo "using $TOOLSET : : $COMPILER ;" > ~/user-config.jam - ./b2 libs/optional/test toolset=$TOOLSET cxxstd=$CXXSTD + - name: Install + run: | + cd ../boost-root/__build__ + cmake --build . --target install - fi + - name: Use the installed library + run: | + cd ../boost-root/libs/$LIBRARY/test/cmake_install_test && mkdir __build__ && cd __build__ + cmake -DCMAKE_INSTALL_PREFIX=~/.local .. + cmake --build . + ctest --output-on-failure --no-tests=error + + posix-cmake-test: + strategy: + fail-fast: false + matrix: + include: + - os: ubuntu-20.04 + - os: ubuntu-22.04 + - os: macos-11 + - os: macos-12 + - os: macos-13 + + runs-on: ${{matrix.os}} + + steps: + - uses: actions/checkout@v3 + + - name: Install packages + if: matrix.install + run: sudo apt-get -y install ${{matrix.install}} + + - name: Setup Boost + run: | + echo GITHUB_REPOSITORY: $GITHUB_REPOSITORY + LIBRARY=${GITHUB_REPOSITORY#*/} + echo LIBRARY: $LIBRARY + echo "LIBRARY=$LIBRARY" >> $GITHUB_ENV + echo GITHUB_BASE_REF: $GITHUB_BASE_REF + echo GITHUB_REF: $GITHUB_REF + REF=${GITHUB_BASE_REF:-$GITHUB_REF} + REF=${REF#refs/heads/} + echo REF: $REF + BOOST_BRANCH=develop && [ "$REF" == "master" ] && BOOST_BRANCH=master || true + echo BOOST_BRANCH: $BOOST_BRANCH + cd .. + git clone -b $BOOST_BRANCH --depth 1 https://github.com/boostorg/boost.git boost-root + cd boost-root + cp -r $GITHUB_WORKSPACE/* libs/$LIBRARY + git submodule update --init tools/boostdep + python tools/boostdep/depinst/depinst.py --git_args "--jobs 3" $LIBRARY + + - name: Configure + run: | + cd ../boost-root + mkdir __build__ && cd __build__ + cmake -DBOOST_INCLUDE_LIBRARIES=$LIBRARY -DBUILD_TESTING=ON .. + + - name: Build tests + run: | + cd ../boost-root/__build__ + cmake --build . --target tests + + - name: Run tests + run: | + cd ../boost-root/__build__ + ctest --output-on-failure --no-tests=error + + windows-cmake-subdir: + strategy: + fail-fast: false + matrix: + include: + - os: windows-2019 + - os: windows-2022 + + runs-on: ${{matrix.os}} + + steps: + - uses: actions/checkout@v3 + + - name: Setup Boost + shell: cmd + run: | + echo GITHUB_REPOSITORY: %GITHUB_REPOSITORY% + for /f %%i in ("%GITHUB_REPOSITORY%") do set LIBRARY=%%~nxi + echo LIBRARY: %LIBRARY% + echo LIBRARY=%LIBRARY%>>%GITHUB_ENV% + echo GITHUB_BASE_REF: %GITHUB_BASE_REF% + echo GITHUB_REF: %GITHUB_REF% + if "%GITHUB_BASE_REF%" == "" set GITHUB_BASE_REF=%GITHUB_REF% + set BOOST_BRANCH=develop + for /f %%i in ("%GITHUB_BASE_REF%") do if "%%~nxi" == "master" set BOOST_BRANCH=master + echo BOOST_BRANCH: %BOOST_BRANCH% + cd .. + git clone -b %BOOST_BRANCH% --depth 1 https://github.com/boostorg/boost.git boost-root + cd boost-root + xcopy /s /e /q %GITHUB_WORKSPACE% libs\%LIBRARY%\ + git submodule update --init tools/boostdep + python tools/boostdep/depinst/depinst.py --git_args "--jobs 3" %LIBRARY% + + - name: Use library with add_subdirectory (Debug) + shell: cmd + run: | + cd ../boost-root/libs/%LIBRARY%/test/cmake_subdir_test + mkdir __build__ && cd __build__ + cmake .. + cmake --build . --config Debug + ctest --output-on-failure --no-tests=error -C Debug + + - name: Use library with add_subdirectory (Release) + shell: cmd + run: | + cd ../boost-root/libs/%LIBRARY%/test/cmake_subdir_test/__build__ + cmake --build . --config Release + ctest --output-on-failure --no-tests=error -C Release + + windows-cmake-install: + strategy: + fail-fast: false + matrix: + include: + - os: windows-2019 + - os: windows-2022 + + runs-on: ${{matrix.os}} + + steps: + - uses: actions/checkout@v3 + + - name: Setup Boost + shell: cmd + run: | + echo GITHUB_REPOSITORY: %GITHUB_REPOSITORY% + for /f %%i in ("%GITHUB_REPOSITORY%") do set LIBRARY=%%~nxi + echo LIBRARY: %LIBRARY% + echo LIBRARY=%LIBRARY%>>%GITHUB_ENV% + echo GITHUB_BASE_REF: %GITHUB_BASE_REF% + echo GITHUB_REF: %GITHUB_REF% + if "%GITHUB_BASE_REF%" == "" set GITHUB_BASE_REF=%GITHUB_REF% + set BOOST_BRANCH=develop + for /f %%i in ("%GITHUB_BASE_REF%") do if "%%~nxi" == "master" set BOOST_BRANCH=master + echo BOOST_BRANCH: %BOOST_BRANCH% + cd .. + git clone -b %BOOST_BRANCH% --depth 1 https://github.com/boostorg/boost.git boost-root + cd boost-root + xcopy /s /e /q %GITHUB_WORKSPACE% libs\%LIBRARY%\ + git submodule update --init tools/boostdep + python tools/boostdep/depinst/depinst.py --git_args "--jobs 3" %LIBRARY% + + - name: Configure + shell: cmd + run: | + cd ../boost-root + mkdir __build__ && cd __build__ + cmake -DBOOST_INCLUDE_LIBRARIES=%LIBRARY% -DCMAKE_INSTALL_PREFIX=C:/cmake-prefix .. + + - name: Install (Debug) + shell: cmd + run: | + cd ../boost-root/__build__ + cmake --build . --target install --config Debug + + - name: Install (Release) + shell: cmd + run: | + cd ../boost-root/__build__ + cmake --build . --target install --config Release + + - name: Use the installed library (Debug) + shell: cmd + run: | + cd ../boost-root/libs/%LIBRARY%/test/cmake_install_test && mkdir __build__ && cd __build__ + cmake -DCMAKE_INSTALL_PREFIX=C:/cmake-prefix .. + cmake --build . --config Debug + ctest --output-on-failure --no-tests=error -C Debug + + - name: Use the installed library (Release) + shell: cmd + run: | + cd ../boost-root/libs/%LIBRARY%/test/cmake_install_test/__build__ + cmake --build . --config Release + ctest --output-on-failure --no-tests=error -C Release + + windows-cmake-test: + strategy: + fail-fast: false + matrix: + include: + - os: windows-2019 + - os: windows-2022 + + runs-on: ${{matrix.os}} + + steps: + - uses: actions/checkout@v3 + + - name: Setup Boost + shell: cmd + run: | + echo GITHUB_REPOSITORY: %GITHUB_REPOSITORY% + for /f %%i in ("%GITHUB_REPOSITORY%") do set LIBRARY=%%~nxi + echo LIBRARY: %LIBRARY% + echo LIBRARY=%LIBRARY%>>%GITHUB_ENV% + echo GITHUB_BASE_REF: %GITHUB_BASE_REF% + echo GITHUB_REF: %GITHUB_REF% + if "%GITHUB_BASE_REF%" == "" set GITHUB_BASE_REF=%GITHUB_REF% + set BOOST_BRANCH=develop + for /f %%i in ("%GITHUB_BASE_REF%") do if "%%~nxi" == "master" set BOOST_BRANCH=master + echo BOOST_BRANCH: %BOOST_BRANCH% + cd .. + git clone -b %BOOST_BRANCH% --depth 1 https://github.com/boostorg/boost.git boost-root + cd boost-root + xcopy /s /e /q %GITHUB_WORKSPACE% libs\%LIBRARY%\ + git submodule update --init tools/boostdep + python tools/boostdep/depinst/depinst.py --git_args "--jobs 3" %LIBRARY% + + - name: Configure + shell: cmd + run: | + cd ../boost-root + mkdir __build__ && cd __build__ + cmake -DBOOST_INCLUDE_LIBRARIES=%LIBRARY% -DBUILD_TESTING=ON .. + + - name: Build tests (Debug) + shell: cmd + run: | + cd ../boost-root/__build__ + cmake --build . --target tests --config Debug + + - name: Run tests (Debug) + shell: cmd + run: | + cd ../boost-root/__build__ + ctest --output-on-failure --no-tests=error -C Debug + + - name: Build tests (Release) + shell: cmd + run: | + cd ../boost-root/__build__ + cmake --build . --target tests --config Release + + - name: Run tests (Release) + shell: cmd + run: | + cd ../boost-root/__build__ + ctest --output-on-failure --no-tests=error -C Release From e962a134f01e01e6b1b64778698a8a456b443720 Mon Sep 17 00:00:00 2001 From: Peter Dimov Date: Mon, 15 Jan 2024 20:10:45 +0200 Subject: [PATCH 101/163] Do not include boost/bind/apply.hpp under C++03 --- test/optional_test.cpp | 3 +++ 1 file changed, 3 insertions(+) diff --git a/test/optional_test.cpp b/test/optional_test.cpp index 81375b8d..bd8f90fc 100644 --- a/test/optional_test.cpp +++ b/test/optional_test.cpp @@ -20,7 +20,10 @@ #define BOOST_ENABLE_ASSERT_HANDLER +#include "boost/config.hpp" +#if !defined(BOOST_NO_CXX11_VARIADIC_TEMPLATES) && !defined(BOOST_NO_CXX11_RVALUE_REFERENCES) #include "boost/bind/apply.hpp" // Included just to test proper interaction with boost::apply<> as reported by Daniel Wallin +#endif #include "boost/mpl/bool.hpp" #include "boost/mpl/bool_fwd.hpp" // For mpl::true_ and mpl::false_ From 5f12573608a7504ed5d4dfa758416f4341f415b2 Mon Sep 17 00:00:00 2001 From: Peter Dimov Date: Mon, 15 Jan 2024 20:11:44 +0200 Subject: [PATCH 102/163] Regenerate CMakeLists.txt with `boostdep --cmake optional` --- CMakeLists.txt | 53 ++++++++++++++++++++++++++++---------------------- 1 file changed, 30 insertions(+), 23 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index f60acf55..aba836f8 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,25 +1,32 @@ -# Copyright 2019 Mike Dev +# Generated by `boostdep --cmake optional` +# Copyright 2020, 2021 Peter Dimov # Distributed under the Boost Software License, Version 1.0. -# See accompanying file LICENSE_1_0.txt or copy at https://www.boost.org/LICENSE_1_0.txt - -cmake_minimum_required( VERSION 3.5...3.20 ) -project( boost_optional VERSION "${BOOST_SUPERPROJECT_VERSION}" LANGUAGES CXX ) - -add_library( boost_optional INTERFACE ) -add_library( Boost::optional ALIAS boost_optional ) - -target_include_directories( boost_optional INTERFACE include ) - -target_link_libraries( boost_optional - INTERFACE - Boost::assert - Boost::config - Boost::core - Boost::detail - Boost::move - Boost::predef - Boost::static_assert - Boost::throw_exception - Boost::type_traits - Boost::utility +# https://www.boost.org/LICENSE_1_0.txt + +cmake_minimum_required(VERSION 3.5...3.20) + +project(boost_optional VERSION "${BOOST_SUPERPROJECT_VERSION}" LANGUAGES CXX) + +add_library(boost_optional INTERFACE) +add_library(Boost::optional ALIAS boost_optional) + +target_include_directories(boost_optional INTERFACE include) + +target_link_libraries(boost_optional + INTERFACE + Boost::assert + Boost::config + Boost::core + Boost::move + Boost::predef + Boost::static_assert + Boost::throw_exception + Boost::type_traits + Boost::utility ) + +if(BUILD_TESTING AND EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/test/CMakeLists.txt") + + add_subdirectory(test) + +endif() From ca1495b69d1cababb3f87cc70c51d560bce6c105 Mon Sep 17 00:00:00 2001 From: Peter Dimov Date: Mon, 15 Jan 2024 20:13:33 +0200 Subject: [PATCH 103/163] Simplify test/Jamfile.v2 so that BoostTestJamfile can parse it --- test/Jamfile.v2 | 144 +++++++++++++++++++++++------------------------- 1 file changed, 70 insertions(+), 74 deletions(-) diff --git a/test/Jamfile.v2 b/test/Jamfile.v2 index 1906eb49..00bf1528 100644 --- a/test/Jamfile.v2 +++ b/test/Jamfile.v2 @@ -15,77 +15,73 @@ import testing ; -{ - test-suite optional : - [ run optional_test.cpp ] - [ run optional_test_assign.cpp ] - [ run optional_test_swap.cpp ] - [ compile optional_test_wuninitialized.cpp ] - [ run optional_test_conversions_from_U.cpp ] - [ run optional_test_convert_from_T.cpp ] - [ run optional_test_convert_assign.cpp ] - [ run optional_test_empty_braces.cpp ] - [ run optional_test_make_optional.cpp ] - [ run optional_test_flat_map.cpp ] - [ run optional_test_hash.cpp ] - [ run optional_test_map.cpp ] - [ run optional_test_tie.cpp ] - [ run optional_test_ref_assign_portable_minimum.cpp ] - [ run optional_test_ref_assign_mutable_int.cpp ] - [ run optional_test_ref_assign_const_int.cpp ] - [ run optional_test_ref_converting_ctor.cpp ] - [ run optional_test_ref_convert_assign_non_int.cpp ] - [ run optional_test_ref_convert_assign_mutable_int.cpp ] - [ run optional_test_ref_convert_assign_const_int.cpp ] - [ run optional_test_ref_portable_minimum.cpp ] - [ run optional_test_ref_move.cpp ] - [ run optional_test_ref_to_val.cpp ] - [ run optional_test_inplace_factory.cpp ] - [ run optional_test_io.cpp ] - [ run optional_test_move.cpp ] - [ run optional_test_noexcept_move.cpp ] - [ run optional_test_equals_none.cpp ] - [ run optional_test_value_access.cpp ] - [ run optional_test_emplace.cpp ] - [ run optional_test_minimum_requirements.cpp ] - [ run optional_test_msvc_bug_workaround.cpp ] - [ run optional_test_member_T.cpp ] - [ run optional_test_tc_base.cpp ] - [ compile optional_test_sfinae_friendly_ctor.cpp ] - [ compile optional_test_path_assignment.cpp ] - [ compile-fail optional_test_fail_const_swap.cpp ] - [ compile-fail optional_test_ref_convert_assign_const_int_prevented.cpp ] - [ compile-fail optional_test_fail1.cpp ] - [ compile-fail optional_test_fail3a.cpp ] - [ compile-fail optional_test_fail3b.cpp ] - [ compile-fail optional_test_ref_fail1.cpp ] - [ compile-fail optional_test_ref_fail3.cpp ] - [ compile-fail optional_test_ref_fail4.cpp ] - [ compile-fail optional_test_inplace_fail.cpp ] - [ compile-fail optional_test_inplace_fail2.cpp ] - [ compile-fail optional_test_fail_implicit_bool_convert.cpp ] - [ compile-fail optional_test_fail_copying_a_moveable_type.cpp ] - [ compile-fail optional_test_fail_optional_rvalue_ref.cpp ] - [ compile-fail optional_test_ref_fail_init_from_Trefref.cpp ] - [ compile-fail optional_test_ref_fail_init_from_Urefref.cpp ] - [ compile-fail optional_test_ref_fail_assign_from_Trefref.cpp ] - [ compile-fail optional_test_ref_fail_assign_from_Urefref.cpp ] - [ compile-fail optional_test_fail_convert_from_null.cpp ] - [ compile-fail optional_test_fail_explicit_convert_in_value_or.cpp ] - [ compile-fail optional_test_fail_explicit_convert_in_value_or_call.cpp ] - [ compile-fail optional_test_fail_io_without_io.cpp ] - [ compile-fail optional_test_fail_none_io_without_io.cpp ] - [ compile-fail optional_test_fail_convert_assign_of_enums.cpp ] - [ run optional_test_static_properties.cpp ] - [ compile optional_test_maybe_uninitialized_warning.cpp ] - [ compile optional_test_deleted_default_ctor.cpp ] - [ compile optional_test_constructible_from_other.cpp ] - #[ run optional_xconfig_HACK_TO_LIST_PREDEFINED_MACROS.cpp ] - [ run optional_xconfig_NO_PROPER_ASSIGN_FROM_CONST_INT_pass.cpp ] - [ run-fail optional_xconfig_NO_PROPER_ASSIGN_FROM_CONST_INT_fail.cpp ] - [ run optional_xconfig_NO_PROPER_CONVERT_FROM_CONST_INT_pass.cpp ] - [ run-fail optional_xconfig_NO_PROPER_CONVERT_FROM_CONST_INT_fail.cpp ] - [ run optional_xconfig_NO_LEGAL_CONVERT_FROM_REF_pass.cpp ] - [ compile-fail optional_xconfig_NO_LEGAL_CONVERT_FROM_REF_fail.cpp ] - ; -} +run optional_test.cpp ; +run optional_test_assign.cpp ; +run optional_test_swap.cpp ; +compile optional_test_wuninitialized.cpp ; +run optional_test_conversions_from_U.cpp ; +run optional_test_convert_from_T.cpp ; +run optional_test_convert_assign.cpp ; +run optional_test_empty_braces.cpp ; +run optional_test_make_optional.cpp ; +run optional_test_flat_map.cpp ; +run optional_test_hash.cpp ; +run optional_test_map.cpp ; +run optional_test_tie.cpp ; +run optional_test_ref_assign_portable_minimum.cpp ; +run optional_test_ref_assign_mutable_int.cpp ; +run optional_test_ref_assign_const_int.cpp ; +run optional_test_ref_converting_ctor.cpp ; +run optional_test_ref_convert_assign_non_int.cpp ; +run optional_test_ref_convert_assign_mutable_int.cpp ; +run optional_test_ref_convert_assign_const_int.cpp ; +run optional_test_ref_portable_minimum.cpp ; +run optional_test_ref_move.cpp ; +run optional_test_ref_to_val.cpp ; +run optional_test_inplace_factory.cpp ; +run optional_test_io.cpp ; +run optional_test_move.cpp ; +run optional_test_noexcept_move.cpp ; +run optional_test_equals_none.cpp ; +run optional_test_value_access.cpp ; +run optional_test_emplace.cpp ; +run optional_test_minimum_requirements.cpp ; +run optional_test_msvc_bug_workaround.cpp ; +run optional_test_member_T.cpp ; +run optional_test_tc_base.cpp ; +compile optional_test_sfinae_friendly_ctor.cpp ; +compile optional_test_path_assignment.cpp ; +compile-fail optional_test_fail_const_swap.cpp ; +compile-fail optional_test_ref_convert_assign_const_int_prevented.cpp ; +compile-fail optional_test_fail1.cpp ; +compile-fail optional_test_fail3a.cpp ; +compile-fail optional_test_fail3b.cpp ; +compile-fail optional_test_ref_fail1.cpp ; +compile-fail optional_test_ref_fail3.cpp ; +compile-fail optional_test_ref_fail4.cpp ; +compile-fail optional_test_inplace_fail.cpp ; +compile-fail optional_test_inplace_fail2.cpp ; +compile-fail optional_test_fail_implicit_bool_convert.cpp ; +compile-fail optional_test_fail_copying_a_moveable_type.cpp ; +compile-fail optional_test_fail_optional_rvalue_ref.cpp ; +compile-fail optional_test_ref_fail_init_from_Trefref.cpp ; +compile-fail optional_test_ref_fail_init_from_Urefref.cpp ; +compile-fail optional_test_ref_fail_assign_from_Trefref.cpp ; +compile-fail optional_test_ref_fail_assign_from_Urefref.cpp ; +compile-fail optional_test_fail_convert_from_null.cpp ; +compile-fail optional_test_fail_explicit_convert_in_value_or.cpp ; +compile-fail optional_test_fail_explicit_convert_in_value_or_call.cpp ; +compile-fail optional_test_fail_io_without_io.cpp ; +compile-fail optional_test_fail_none_io_without_io.cpp ; +compile-fail optional_test_fail_convert_assign_of_enums.cpp ; +run optional_test_static_properties.cpp ; +compile optional_test_maybe_uninitialized_warning.cpp ; +compile optional_test_deleted_default_ctor.cpp ; +compile optional_test_constructible_from_other.cpp ; +#run optional_xconfig_HACK_TO_LIST_PREDEFINED_MACROS.cpp ; +run optional_xconfig_NO_PROPER_ASSIGN_FROM_CONST_INT_pass.cpp ; +run-fail optional_xconfig_NO_PROPER_ASSIGN_FROM_CONST_INT_fail.cpp ; +run optional_xconfig_NO_PROPER_CONVERT_FROM_CONST_INT_pass.cpp ; +run-fail optional_xconfig_NO_PROPER_CONVERT_FROM_CONST_INT_fail.cpp ; +run optional_xconfig_NO_LEGAL_CONVERT_FROM_REF_pass.cpp ; +compile-fail optional_xconfig_NO_LEGAL_CONVERT_FROM_REF_fail.cpp ; From 7a5386eeebb4bf7f8c1139d476acc8227ee983c7 Mon Sep 17 00:00:00 2001 From: Peter Dimov Date: Mon, 15 Jan 2024 20:14:51 +0200 Subject: [PATCH 104/163] Add test/CMakeLists.txt --- test/CMakeLists.txt | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 test/CMakeLists.txt diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt new file mode 100644 index 00000000..00fa463a --- /dev/null +++ b/test/CMakeLists.txt @@ -0,0 +1,11 @@ +# Copyright 2018, 2019 Peter Dimov +# Distributed under the Boost Software License, Version 1.0. +# See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt + +include(BoostTestJamfile OPTIONAL RESULT_VARIABLE HAVE_BOOST_TEST) + +if(HAVE_BOOST_TEST) + +boost_test_jamfile(FILE Jamfile.v2 LINK_LIBRARIES Boost::optional Boost::core) + +endif() From 88428d350d0d5d3ed3ead0bd8c8f58dd30b56b7a Mon Sep 17 00:00:00 2001 From: Peter Dimov Date: Mon, 15 Jan 2024 20:20:20 +0200 Subject: [PATCH 105/163] Add test/cmake_install_test, test/cmake_subdir_test --- test/cmake_install_test/CMakeLists.txt | 17 +++++++++++++++++ test/cmake_install_test/main.cpp | 13 +++++++++++++ test/cmake_subdir_test/CMakeLists.txt | 18 ++++++++++++++++++ test/cmake_subdir_test/main.cpp | 13 +++++++++++++ 4 files changed, 61 insertions(+) create mode 100644 test/cmake_install_test/CMakeLists.txt create mode 100644 test/cmake_install_test/main.cpp create mode 100644 test/cmake_subdir_test/CMakeLists.txt create mode 100644 test/cmake_subdir_test/main.cpp diff --git a/test/cmake_install_test/CMakeLists.txt b/test/cmake_install_test/CMakeLists.txt new file mode 100644 index 00000000..dcc1e797 --- /dev/null +++ b/test/cmake_install_test/CMakeLists.txt @@ -0,0 +1,17 @@ +# Copyright 2018, 2019 Peter Dimov +# Distributed under the Boost Software License, Version 1.0. +# See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt + +cmake_minimum_required(VERSION 3.5...3.16) + +project(cmake_subdir_test LANGUAGES CXX) + +find_package(boost_optional REQUIRED) + +add_executable(main main.cpp) +target_link_libraries(main Boost::optional) + +enable_testing() +add_test(main main) + +add_custom_target(check COMMAND ${CMAKE_CTEST_COMMAND} --output-on-failure -C $) diff --git a/test/cmake_install_test/main.cpp b/test/cmake_install_test/main.cpp new file mode 100644 index 00000000..f17b4a32 --- /dev/null +++ b/test/cmake_install_test/main.cpp @@ -0,0 +1,13 @@ +// Copyright 2024 Peter Dimov +// Distributed under the Boost Software License, Version 1.0. +// https://www.boost.org/LICENSE_1_0.txt + +#include + +int main() +{ + boost::optional o1; + boost::optional o2( 0 ); + o1 = o2; + return *o1; +} diff --git a/test/cmake_subdir_test/CMakeLists.txt b/test/cmake_subdir_test/CMakeLists.txt new file mode 100644 index 00000000..1b860f0e --- /dev/null +++ b/test/cmake_subdir_test/CMakeLists.txt @@ -0,0 +1,18 @@ +# Copyright 2018, 2019 Peter Dimov +# Distributed under the Boost Software License, Version 1.0. +# See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt + +cmake_minimum_required(VERSION 3.5...3.16) + +project(cmake_subdir_test LANGUAGES CXX) + +set(BOOST_INCLUDE_LIBRARIES optional) +add_subdirectory(../../../.. boostorg/boost) + +add_executable(main main.cpp) +target_link_libraries(main Boost::optional) + +enable_testing() +add_test(main main) + +add_custom_target(check COMMAND ${CMAKE_CTEST_COMMAND} --output-on-failure -C $) diff --git a/test/cmake_subdir_test/main.cpp b/test/cmake_subdir_test/main.cpp new file mode 100644 index 00000000..f17b4a32 --- /dev/null +++ b/test/cmake_subdir_test/main.cpp @@ -0,0 +1,13 @@ +// Copyright 2024 Peter Dimov +// Distributed under the Boost Software License, Version 1.0. +// https://www.boost.org/LICENSE_1_0.txt + +#include + +int main() +{ + boost::optional o1; + boost::optional o2( 0 ); + o1 = o2; + return *o1; +} From 3d8f71728c550a2981afe1607bfef8daf1e96b28 Mon Sep 17 00:00:00 2001 From: Peter Dimov Date: Mon, 15 Jan 2024 20:22:44 +0200 Subject: [PATCH 106/163] Link tests to Boost::bind and Boost::mpl, because optional_test includes them --- test/CMakeLists.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt index 00fa463a..35b79692 100644 --- a/test/CMakeLists.txt +++ b/test/CMakeLists.txt @@ -6,6 +6,6 @@ include(BoostTestJamfile OPTIONAL RESULT_VARIABLE HAVE_BOOST_TEST) if(HAVE_BOOST_TEST) -boost_test_jamfile(FILE Jamfile.v2 LINK_LIBRARIES Boost::optional Boost::core) +boost_test_jamfile(FILE Jamfile.v2 LINK_LIBRARIES Boost::optional Boost::core Boost::bind Boost::mpl) endif() From 85e50fe91966a1dcb7f9bc185d57c392f9f17b55 Mon Sep 17 00:00:00 2001 From: Peter Dimov Date: Mon, 15 Jan 2024 20:26:35 +0200 Subject: [PATCH 107/163] Link tests to Boost::tuple, because optional_test_tie uses it --- test/CMakeLists.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt index 35b79692..eedb6f8c 100644 --- a/test/CMakeLists.txt +++ b/test/CMakeLists.txt @@ -6,6 +6,6 @@ include(BoostTestJamfile OPTIONAL RESULT_VARIABLE HAVE_BOOST_TEST) if(HAVE_BOOST_TEST) -boost_test_jamfile(FILE Jamfile.v2 LINK_LIBRARIES Boost::optional Boost::core Boost::bind Boost::mpl) +boost_test_jamfile(FILE Jamfile.v2 LINK_LIBRARIES Boost::optional Boost::core Boost::bind Boost::mpl Boost::tuple) endif() From b5e9f067a730cb778ddef50ecfc89d1e112934c5 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Mon, 15 Jan 2024 19:59:05 +0100 Subject: [PATCH 108/163] Stop linking to Boost::detail --- CMakeLists.txt | 1 - 1 file changed, 1 deletion(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index f60acf55..f69f0ae6 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -15,7 +15,6 @@ target_link_libraries( boost_optional Boost::assert Boost::config Boost::core - Boost::detail Boost::move Boost::predef Boost::static_assert From 7ed6bf5bcaf58b3610855accb7da3535a03b0b4c Mon Sep 17 00:00:00 2001 From: Rene Rivera Date: Mon, 11 Mar 2024 08:38:17 -0500 Subject: [PATCH 109/163] Make the library modular usable. --- build.jam | 29 +++++++++++++++++++++++++++++ test/Jamfile.v2 | 4 ++-- 2 files changed, 31 insertions(+), 2 deletions(-) create mode 100644 build.jam diff --git a/build.jam b/build.jam new file mode 100644 index 00000000..277138b9 --- /dev/null +++ b/build.jam @@ -0,0 +1,29 @@ +# Copyright René Ferdinand Rivera Morell 2023 +# Distributed under the Boost Software License, Version 1.0. +# (See accompanying file LICENSE_1_0.txt or copy at +# http://www.boost.org/LICENSE_1_0.txt) + +import project ; + +project /boost/optional + : common-requirements + /boost/assert//boost_assert + /boost/config//boost_config + /boost/core//boost_core + /boost/detail//boost_detail + /boost/move//boost_move + /boost/predef//boost_predef + /boost/static_assert//boost_static_assert + /boost/throw_exception//boost_throw_exception + /boost/type_traits//boost_type_traits + /boost/utility//boost_utility + include + ; + +explicit + [ alias boost_optional ] + [ alias all : boost_optional test ] + ; + +call-if : boost-library optional + ; diff --git a/test/Jamfile.v2 b/test/Jamfile.v2 index 00bf1528..41ed8877 100644 --- a/test/Jamfile.v2 +++ b/test/Jamfile.v2 @@ -15,7 +15,7 @@ import testing ; -run optional_test.cpp ; +run optional_test.cpp : : : /boost/bind//boost_bind /boost/mpl//boost_mpl ; run optional_test_assign.cpp ; run optional_test_swap.cpp ; compile optional_test_wuninitialized.cpp ; @@ -27,7 +27,7 @@ run optional_test_make_optional.cpp ; run optional_test_flat_map.cpp ; run optional_test_hash.cpp ; run optional_test_map.cpp ; -run optional_test_tie.cpp ; +run optional_test_tie.cpp : : : /boost/tuple//boost_tuple ; run optional_test_ref_assign_portable_minimum.cpp ; run optional_test_ref_assign_mutable_int.cpp ; run optional_test_ref_assign_const_int.cpp ; From 81f4543d814cb40f41bc2479bb20f8d1c7c7058a Mon Sep 17 00:00:00 2001 From: Rene Rivera Date: Fri, 29 Mar 2024 21:15:59 -0500 Subject: [PATCH 110/163] Switch to library requirements instead of source. As source puts extra source in install targets. --- build.jam | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/build.jam b/build.jam index 277138b9..78e57234 100644 --- a/build.jam +++ b/build.jam @@ -7,16 +7,16 @@ import project ; project /boost/optional : common-requirements - /boost/assert//boost_assert - /boost/config//boost_config - /boost/core//boost_core - /boost/detail//boost_detail - /boost/move//boost_move - /boost/predef//boost_predef - /boost/static_assert//boost_static_assert - /boost/throw_exception//boost_throw_exception - /boost/type_traits//boost_type_traits - /boost/utility//boost_utility + /boost/assert//boost_assert + /boost/config//boost_config + /boost/core//boost_core + /boost/detail//boost_detail + /boost/move//boost_move + /boost/predef//boost_predef + /boost/static_assert//boost_static_assert + /boost/throw_exception//boost_throw_exception + /boost/type_traits//boost_type_traits + /boost/utility//boost_utility include ; From 1f473d259697bbd0b5355750a241cc7feccf50c2 Mon Sep 17 00:00:00 2001 From: Rene Rivera Date: Sun, 5 May 2024 09:00:01 -0500 Subject: [PATCH 111/163] Add requires-b2 check to top-level build file. --- build.jam | 2 ++ 1 file changed, 2 insertions(+) diff --git a/build.jam b/build.jam index 78e57234..0600c231 100644 --- a/build.jam +++ b/build.jam @@ -3,6 +3,8 @@ # (See accompanying file LICENSE_1_0.txt or copy at # http://www.boost.org/LICENSE_1_0.txt) +require-b2 5.1 ; + import project ; project /boost/optional From 9a2c5ec37b1e2d1846f774a857da1820ab0cf21b Mon Sep 17 00:00:00 2001 From: Rene Rivera Date: Mon, 13 May 2024 21:46:33 -0500 Subject: [PATCH 112/163] Update dependencies. --- build.jam | 1 - 1 file changed, 1 deletion(-) diff --git a/build.jam b/build.jam index 0600c231..351a50f4 100644 --- a/build.jam +++ b/build.jam @@ -12,7 +12,6 @@ project /boost/optional /boost/assert//boost_assert /boost/config//boost_config /boost/core//boost_core - /boost/detail//boost_detail /boost/move//boost_move /boost/predef//boost_predef /boost/static_assert//boost_static_assert From 6bd32078b4ce59f69ba6878db604f31d77a9a569 Mon Sep 17 00:00:00 2001 From: Rene Rivera Date: Fri, 14 Jun 2024 11:33:56 -0500 Subject: [PATCH 113/163] Bump B2 require to 5.2 --- build.jam | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/build.jam b/build.jam index 351a50f4..a56da64d 100644 --- a/build.jam +++ b/build.jam @@ -3,9 +3,7 @@ # (See accompanying file LICENSE_1_0.txt or copy at # http://www.boost.org/LICENSE_1_0.txt) -require-b2 5.1 ; - -import project ; +require-b2 5.2 ; project /boost/optional : common-requirements From 22657e9c6eb188627839a91c703f7ef1c071bbcf Mon Sep 17 00:00:00 2001 From: Tosiekdev <92332506+Tosiekdev@users.noreply.github.com> Date: Tue, 9 Jul 2024 20:12:22 +0200 Subject: [PATCH 114/163] Misspelled word "from" --- doc/00_optional.qbk | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/00_optional.qbk b/doc/00_optional.qbk index 2381794e..093df84f 100644 --- a/doc/00_optional.qbk +++ b/doc/00_optional.qbk @@ -54,7 +54,7 @@ Distributed under the Boost Software License, Version 1.0. Class template `optional` is a wrapper for representing 'optional' (or 'nullable') objects who may not (yet) contain a valid value. Optional objects offer full value semantics; they are good for passing by value and usage inside STL containers. This is a header-only library. [heading Problem] -Suppose we want to read a parameter form a config file which represents some integral value, let's call it `"MaxValue"`. It is possible that this parameter is not specified; such situation is no error. It is valid to not specify the parameter and in that case the program is supposed to behave slightly differently. Also, suppose that any possible value of type `int` is a valid value for `"MaxValue"`, so we cannot just use `-1` to represent the absence of the parameter in the config file. +Suppose we want to read a parameter from a config file which represents some integral value, let's call it `"MaxValue"`. It is possible that this parameter is not specified; such situation is no error. It is valid to not specify the parameter and in that case the program is supposed to behave slightly differently. Also, suppose that any possible value of type `int` is a valid value for `"MaxValue"`, so we cannot just use `-1` to represent the absence of the parameter in the config file. [heading Solution] From 8ffcf0f369ce2becc03e3938607cc492d03a795e Mon Sep 17 00:00:00 2001 From: Rene Rivera Date: Sat, 20 Jul 2024 19:41:37 -0500 Subject: [PATCH 115/163] Change all references to . --- test/Jamfile.v2 | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/test/Jamfile.v2 b/test/Jamfile.v2 index 41ed8877..0f6124c3 100644 --- a/test/Jamfile.v2 +++ b/test/Jamfile.v2 @@ -15,7 +15,7 @@ import testing ; -run optional_test.cpp : : : /boost/bind//boost_bind /boost/mpl//boost_mpl ; +run optional_test.cpp : : : /boost/bind//boost_bind /boost/mpl//boost_mpl ; run optional_test_assign.cpp ; run optional_test_swap.cpp ; compile optional_test_wuninitialized.cpp ; @@ -27,7 +27,7 @@ run optional_test_make_optional.cpp ; run optional_test_flat_map.cpp ; run optional_test_hash.cpp ; run optional_test_map.cpp ; -run optional_test_tie.cpp : : : /boost/tuple//boost_tuple ; +run optional_test_tie.cpp : : : /boost/tuple//boost_tuple ; run optional_test_ref_assign_portable_minimum.cpp ; run optional_test_ref_assign_mutable_int.cpp ; run optional_test_ref_assign_const_int.cpp ; From dfe19159308665e4e5fe0cfa6b013ea89f9059b6 Mon Sep 17 00:00:00 2001 From: Rene Rivera Date: Sat, 20 Jul 2024 22:52:04 -0500 Subject: [PATCH 116/163] Update copyright dates. --- build.jam | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/build.jam b/build.jam index a56da64d..9efbcaae 100644 --- a/build.jam +++ b/build.jam @@ -1,4 +1,4 @@ -# Copyright René Ferdinand Rivera Morell 2023 +# Copyright René Ferdinand Rivera Morell 2023-2024 # Distributed under the Boost Software License, Version 1.0. # (See accompanying file LICENSE_1_0.txt or copy at # http://www.boost.org/LICENSE_1_0.txt) From bf10cf91c2c367ac925dd79b748d89c06143b947 Mon Sep 17 00:00:00 2001 From: Rene Rivera Date: Tue, 23 Jul 2024 22:34:22 -0500 Subject: [PATCH 117/163] Move inter-lib dependencies to a project variable and into the build targets. --- build.jam | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/build.jam b/build.jam index 9efbcaae..91e6606b 100644 --- a/build.jam +++ b/build.jam @@ -5,24 +5,27 @@ require-b2 5.2 ; +constant boost_dependencies : + /boost/assert//boost_assert + /boost/config//boost_config + /boost/core//boost_core + /boost/move//boost_move + /boost/predef//boost_predef + /boost/static_assert//boost_static_assert + /boost/throw_exception//boost_throw_exception + /boost/type_traits//boost_type_traits + /boost/utility//boost_utility ; + project /boost/optional : common-requirements - /boost/assert//boost_assert - /boost/config//boost_config - /boost/core//boost_core - /boost/move//boost_move - /boost/predef//boost_predef - /boost/static_assert//boost_static_assert - /boost/throw_exception//boost_throw_exception - /boost/type_traits//boost_type_traits - /boost/utility//boost_utility include ; explicit - [ alias boost_optional ] + [ alias boost_optional : : : : $(boost_dependencies) ] [ alias all : boost_optional test ] ; call-if : boost-library optional ; + From 4c503758fe74665c51917039f1ec2d505186f207 Mon Sep 17 00:00:00 2001 From: Rene Rivera Date: Sun, 4 Aug 2024 11:58:57 -0500 Subject: [PATCH 118/163] Update build deps. --- test/Jamfile.v2 | 2 ++ 1 file changed, 2 insertions(+) diff --git a/test/Jamfile.v2 b/test/Jamfile.v2 index 0f6124c3..f06d4aaa 100644 --- a/test/Jamfile.v2 +++ b/test/Jamfile.v2 @@ -15,6 +15,8 @@ import testing ; +project : requirements /boost/optional//boost_optional ; + run optional_test.cpp : : : /boost/bind//boost_bind /boost/mpl//boost_mpl ; run optional_test_assign.cpp ; run optional_test_swap.cpp ; From 82d08adf119d9fd2f99fe02d25ff4c5895bb4a6e Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 15 Aug 2024 01:48:31 +0200 Subject: [PATCH 119/163] Drop support for C++03 --- doc/91_relnotes.qbk | 5 ++ include/boost/none_t.hpp | 5 +- .../detail/optional_reference_spec.hpp | 83 ++++++++++--------- include/boost/optional/optional.hpp | 35 ++++---- test/optional_test_msvc_bug_workaround.cpp | 8 +- 5 files changed, 71 insertions(+), 65 deletions(-) diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index cadccbec..781d4064 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -11,6 +11,11 @@ [section:relnotes Release Notes] +[heading Boost Release 1.87] + +* *Breaking change.* Dropped support for C++03. C++11 is now the required minimum. + + [heading Boost Release 1.85] * Fixed the implementation for trivial types. Now it is slower, because it always initializes the `T`, but it avoids undefined behavior when `optional` is copied. This fixes [@https://github.com/boostorg/optional/issues/108 issue #108]. diff --git a/include/boost/none_t.hpp b/include/boost/none_t.hpp index 419a7286..0f95128f 100644 --- a/include/boost/none_t.hpp +++ b/include/boost/none_t.hpp @@ -1,5 +1,5 @@ // Copyright (C) 2003, Fernando Luis Cacciola Carballal. -// Copyright (C) 2014, 2015 Andrzej Krzemienski. +// Copyright (C) 2014, 2024 Andrzej Krzemienski. // // Use, modification, and distribution is subject to the Boost Software // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at @@ -14,12 +14,11 @@ #define BOOST_NONE_T_17SEP2003_HPP #include -#include #if defined (BOOST_NO_CXX11_RVALUE_REFERENCES) || defined(BOOST_NO_CXX11_VARIADIC_TEMPLATES) || defined(BOOST_NO_CXX11_REF_QUALIFIERS) \ || defined(BOOST_NO_CXX11_LAMBDAS) || defined(BOOST_NO_CXX11_DECLTYPE_N3276) || defined(BOOST_NO_CXX11_NOEXCEPT) || defined(BOOST_NO_CXX11_DELETED_FUNCTIONS) || defined(BOOST_NO_CXX11_DEFAULTED_FUNCTIONS) || defined(BOOST_NO_CXX11_DEFAULTED_MOVES) || defined(BOOST_NO_CXX11_EXPLICIT_CONVERSION_OPERATORS) -BOOST_PRAGMA_MESSAGE("C++03 support is deprecated in Boost.Optional 1.83 and will be removed in Boost.Optional 1.86.") +#error "Boost.Optional requires C++11 or later. If you have an older C++ version use Boost.Optional version 1.86 or earlier." #endif diff --git a/include/boost/optional/detail/optional_reference_spec.hpp b/include/boost/optional/detail/optional_reference_spec.hpp index b013f0b5..3be3d330 100644 --- a/include/boost/optional/detail/optional_reference_spec.hpp +++ b/include/boost/optional/detail/optional_reference_spec.hpp @@ -1,4 +1,4 @@ -// Copyright (C) 2015-2018 Andrzej Krzemienski. +// Copyright (C) 2015-2024 Andrzej Krzemienski. // // Use, modification, and distribution is subject to the Boost Software // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at @@ -29,15 +29,15 @@ template void prevent_binding_rvalue() { #ifndef BOOST_OPTIONAL_CONFIG_ALLOW_BINDING_TO_RVALUES - BOOST_STATIC_ASSERT_MSG(boost::is_lvalue_reference::value, + BOOST_STATIC_ASSERT_MSG(boost::is_lvalue_reference::value, "binding rvalue references to optional lvalue references is disallowed"); -#endif +#endif } template BOOST_DEDUCED_TYPENAME boost::remove_reference::type& forward_reference(T&& r) { - BOOST_STATIC_ASSERT_MSG(boost::is_lvalue_reference::value, + BOOST_STATIC_ASSERT_MSG(boost::is_lvalue_reference::value, "binding rvalue references to optional lvalue references is disallowed"); return boost::forward(r); } @@ -68,10 +68,10 @@ void prevent_assignment_from_false_const_integral() #ifdef BOOST_OPTIONAL_CONFIG_NO_PROPER_ASSIGN_FROM_CONST_INT // MSVC compiler without rvalue references: we need to disable the assignment from // const integral lvalue reference, as it may be an invalid temporary - BOOST_STATIC_ASSERT_MSG(!is_const_integral::value, + BOOST_STATIC_ASSERT_MSG(!is_const_integral::value, "binding const lvalue references to integral types is disabled in this compiler"); #endif -#endif +#endif } @@ -114,7 +114,7 @@ template class optional : public optional_detail::optional_tag { T* ptr_; - + public: typedef T& value_type; typedef T& reference_type; @@ -122,19 +122,19 @@ class optional : public optional_detail::optional_tag typedef T& rval_reference_type; typedef T* pointer_type; typedef T* pointer_const_type; - + optional() BOOST_NOEXCEPT : ptr_() {} - optional(none_t) BOOST_NOEXCEPT : ptr_() {} + optional(none_t) BOOST_NOEXCEPT : ptr_() {} template explicit optional(const optional& rhs) BOOST_NOEXCEPT : ptr_(rhs.get_ptr()) {} optional(const optional& rhs) BOOST_NOEXCEPT : ptr_(rhs.get_ptr()) {} - + // the following two implement a 'conditionally explicit' constructor: condition is a hack for buggy compilers with screwed conversion construction from const int template explicit optional(U& rhs, BOOST_DEDUCED_TYPENAME boost::enable_if_c::value && detail::is_const_integral_bad_for_conversion::value, bool>::type = true) BOOST_NOEXCEPT : ptr_(boost::addressof(rhs)) {} - + template optional(U& rhs, BOOST_DEDUCED_TYPENAME boost::enable_if_c::value && !detail::is_const_integral_bad_for_conversion::value, bool>::type = true) BOOST_NOEXCEPT : ptr_(boost::addressof(rhs)) {} @@ -143,15 +143,15 @@ class optional : public optional_detail::optional_tag template optional& operator=(const optional& rhs) BOOST_NOEXCEPT { ptr_ = rhs.get_ptr(); return *this; } optional& operator=(none_t) BOOST_NOEXCEPT { ptr_ = 0; return *this; } - - + + void swap(optional& rhs) BOOST_NOEXCEPT { std::swap(ptr_, rhs.ptr_); } T& get() const { BOOST_ASSERT(ptr_); return *ptr_; } T* get_ptr() const BOOST_NOEXCEPT { return ptr_; } T* operator->() const { BOOST_ASSERT(ptr_); return ptr_; } T& operator*() const { BOOST_ASSERT(ptr_); return *ptr_; } - + T& value() const { if (this->is_initialized()) @@ -159,17 +159,17 @@ class optional : public optional_detail::optional_tag else throw_exception(bad_optional_access()); } - - bool operator!() const BOOST_NOEXCEPT { return ptr_ == 0; } + + bool operator!() const BOOST_NOEXCEPT { return ptr_ == 0; } BOOST_EXPLICIT_OPERATOR_BOOL_NOEXCEPT() - + void reset() BOOST_NOEXCEPT { ptr_ = 0; } bool is_initialized() const BOOST_NOEXCEPT { return ptr_ != 0; } bool has_value() const BOOST_NOEXCEPT { return ptr_ != 0; } - + template - optional::type> map(F f) const + auto map(F f) const -> optional { if (this->has_value()) return f(this->get()); @@ -178,61 +178,62 @@ class optional : public optional_detail::optional_tag } template - optional::type>::type> flat_map(F f) const + auto flat_map(F f) const -> + optional::type> { if (this->has_value()) return f(get()); else return none; } - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - + +#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES + optional(T&& /* rhs */) BOOST_NOEXCEPT { detail::prevent_binding_rvalue(); } - + template optional(R&& r, BOOST_DEDUCED_TYPENAME boost::enable_if, bool>::type = true) BOOST_NOEXCEPT : ptr_(boost::addressof(r)) { detail::prevent_binding_rvalue(); } - + template optional(bool cond, R&& r, BOOST_DEDUCED_TYPENAME boost::enable_if, bool>::type = true) BOOST_NOEXCEPT : ptr_(cond ? boost::addressof(r) : 0) { detail::prevent_binding_rvalue(); } - + template BOOST_DEDUCED_TYPENAME boost::enable_if, optional&>::type operator=(R&& r) BOOST_NOEXCEPT { detail::prevent_binding_rvalue(); ptr_ = boost::addressof(r); return *this; } - + template void emplace(R&& r, BOOST_DEDUCED_TYPENAME boost::enable_if, bool>::type = true) BOOST_NOEXCEPT { detail::prevent_binding_rvalue(); ptr_ = boost::addressof(r); } - + template T& get_value_or(R&& r, BOOST_DEDUCED_TYPENAME boost::enable_if, bool>::type = true) const BOOST_NOEXCEPT { detail::prevent_binding_rvalue(); return ptr_ ? *ptr_ : r; } - + template T& value_or(R&& r, BOOST_DEDUCED_TYPENAME boost::enable_if, bool>::type = true) const BOOST_NOEXCEPT { detail::prevent_binding_rvalue(); return ptr_ ? *ptr_ : r; } - + template void reset(R&& r, BOOST_DEDUCED_TYPENAME boost::enable_if, bool>::type = true) BOOST_NOEXCEPT { detail::prevent_binding_rvalue(); ptr_ = boost::addressof(r); } - + template T& value_or_eval(F f) const { return ptr_ ? *ptr_ : detail::forward_reference(f()); } - + #else // BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - + // the following two implement a 'conditionally explicit' constructor template explicit optional(U& v, BOOST_DEDUCED_TYPENAME boost::enable_if_c::value && detail::is_const_integral_bad_for_conversion::value, bool>::type = true) BOOST_NOEXCEPT : ptr_(boost::addressof(v)) { } - + template optional(U& v, BOOST_DEDUCED_TYPENAME boost::enable_if_c::value && !detail::is_const_integral_bad_for_conversion::value, bool>::type = true) BOOST_NOEXCEPT : ptr_(boost::addressof(v)) { } - + template optional(bool cond, U& v, BOOST_DEDUCED_TYPENAME boost::enable_if, bool>::type = true) BOOST_NOEXCEPT : ptr_(cond ? boost::addressof(v) : 0) {} @@ -247,26 +248,26 @@ class optional : public optional_detail::optional_tag template void emplace(U& v, BOOST_DEDUCED_TYPENAME boost::enable_if, bool>::type = true) BOOST_NOEXCEPT { ptr_ = boost::addressof(v); } - + template T& get_value_or(U& v, BOOST_DEDUCED_TYPENAME boost::enable_if, bool>::type = true) const BOOST_NOEXCEPT { return ptr_ ? *ptr_ : v; } - + template T& value_or(U& v, BOOST_DEDUCED_TYPENAME boost::enable_if, bool>::type = true) const BOOST_NOEXCEPT { return ptr_ ? *ptr_ : v; } - + template void reset(U& v, BOOST_DEDUCED_TYPENAME boost::enable_if, bool>::type = true) BOOST_NOEXCEPT { ptr_ = boost::addressof(v); } - + template T& value_or_eval(F f) const { return ptr_ ? *ptr_ : f(); } - + #endif // BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES }; -template +template void swap ( optional& x, optional& y) BOOST_NOEXCEPT { x.swap(y); diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 99245ff4..22221d29 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -60,7 +60,6 @@ #include #include #include -#include #include #include @@ -75,12 +74,15 @@ struct optional_value_type { }; -template -struct optional_value_type< ::boost::optional > +template +struct optional_value_type< ::boost::optional > { - typedef T type; + typedef U type; }; +template +T declval(); + }} // namespace boost::optional_detail namespace boost { @@ -1381,7 +1383,6 @@ class optional } #endif - #if (!defined BOOST_NO_CXX11_REF_QUALIFIERS) && (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) template value_type value_or_eval ( F f ) const& @@ -1402,7 +1403,7 @@ class optional } template - optional::type> map(F f) & + optional()(optional_detail::declval()))> map(F f) & { if (this->has_value()) return f(get()); @@ -1411,7 +1412,7 @@ class optional } template - optional::type> map(F f) const& + optional()(optional_detail::declval()))> map(F f) const& { if (this->has_value()) return f(get()); @@ -1420,7 +1421,7 @@ class optional } template - optional::type> map(F f) && + optional()(optional_detail::declval()))> map(F f) && { if (this->has_value()) return f(boost::move(this->get())); @@ -1429,7 +1430,7 @@ class optional } template - optional::type>::type> flat_map(F f) & + optional()(optional_detail::declval()))>::type> flat_map(F f) & { if (this->has_value()) return f(get()); @@ -1438,7 +1439,7 @@ class optional } template - optional::type>::type> flat_map(F f) const& + optional()(optional_detail::declval()))>::type>flat_map(F f) const& { if (this->has_value()) return f(get()); @@ -1447,7 +1448,7 @@ class optional } template - optional::type>::type> flat_map(F f) && + optional()(optional_detail::declval()))>::type>flat_map(F f) && { if (this->has_value()) return f(boost::move(get())); @@ -1466,7 +1467,7 @@ class optional } template - optional::type> map(F f) + optional()(optional_detail::declval()))> map(F f) { if (this->has_value()) return f(get()); @@ -1475,7 +1476,7 @@ class optional } template - optional::type> map(F f) const + optional()(optional_detail::declval()))> map(F f) const { if (this->has_value()) return f(get()); @@ -1484,7 +1485,7 @@ class optional } template - optional::type>::type> flat_map(F f) + optional()(optional_detail::declval()))>::type> flat_map(F f) { if (this->has_value()) return f(get()); @@ -1493,7 +1494,7 @@ class optional } template - optional::type>::type> flat_map(F f) const + optional()(optional_detail::declval()))>::type> flat_map(F f) const { if (this->has_value()) return f(get()); @@ -1505,9 +1506,7 @@ class optional bool has_value() const BOOST_NOEXCEPT { return this->is_initialized() ; } - bool operator!() const BOOST_NOEXCEPT { return !this->is_initialized() ; } - - BOOST_EXPLICIT_OPERATOR_BOOL_NOEXCEPT() + explicit operator bool() const BOOST_NOEXCEPT { return this->has_value() ; } } ; diff --git a/test/optional_test_msvc_bug_workaround.cpp b/test/optional_test_msvc_bug_workaround.cpp index 126e8850..8d370682 100644 --- a/test/optional_test_msvc_bug_workaround.cpp +++ b/test/optional_test_msvc_bug_workaround.cpp @@ -29,13 +29,15 @@ void test() { #if (!defined BOOST_NO_CXX11_RVALUE_REFERENCES) boost::optional v = Wrapper(); - BOOST_TEST(v); + //BOOST_TEST(v); + boost::optional> vv; + bool xx = vv?true : false; BOOST_TEST_EQ(*v, 7); #endif -} +} int main() { test(); return boost::report_errors(); -} \ No newline at end of file +} From 3a8556186ebc778176863b01060043d6aa1d3cc0 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 15 Aug 2024 08:49:21 +0200 Subject: [PATCH 120/163] Drop dependency on Boost.Utility --- doc/90_dependencies.qbk | 3 +-- doc/91_relnotes.qbk | 2 ++ .../boost/optional/detail/optional_relops.hpp | 20 +++++++++---------- include/boost/optional/optional.hpp | 1 - 4 files changed, 13 insertions(+), 13 deletions(-) diff --git a/doc/90_dependencies.qbk b/doc/90_dependencies.qbk index 0dab296e..d033b08a 100644 --- a/doc/90_dependencies.qbk +++ b/doc/90_dependencies.qbk @@ -18,11 +18,10 @@ The implementation uses the following other Boost modules: # config # core # move -# mpl +# predef # static_assert # throw_exception # type_traits -# utility [endsect] diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index 781d4064..9307a242 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -14,6 +14,8 @@ [heading Boost Release 1.87] * *Breaking change.* Dropped support for C++03. C++11 is now the required minimum. +* Dropped dependency on Boost.Utility. +* A bit faster implementation of some relational operations. [heading Boost Release 1.85] diff --git a/include/boost/optional/detail/optional_relops.hpp b/include/boost/optional/detail/optional_relops.hpp index 1c155787..c7766fc9 100644 --- a/include/boost/optional/detail/optional_relops.hpp +++ b/include/boost/optional/detail/optional_relops.hpp @@ -1,5 +1,5 @@ // Copyright (C) 2003, 2008 Fernando Luis Cacciola Carballal. -// Copyright (C) 2015 Andrzej Krzemienski. +// Copyright (C) 2015, 2024 Andrzej Krzemienski. // // Use, modification, and distribution is subject to the Boost Software // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at @@ -16,7 +16,8 @@ namespace boost { // optional's relational operators ( ==, !=, <, >, <=, >= ) have deep-semantics (compare values). -// WARNING: This is UNLIKE pointers. Use equal_pointees()/less_pointees() in generic code instead. +// WARNING: This is UNLIKE pointers. Use equal_pointees()/less_pointees() in generic code instead, +// to obtain the same semantic for pointers. // @@ -31,7 +32,7 @@ bool operator == ( optional const& x, optional const& y ) template inline bool operator < ( optional const& x, optional const& y ) -{ return less_pointees(x,y); } +{ return !y ? false : (!x ? true : (*x) < (*y)); } template inline @@ -60,12 +61,12 @@ bool operator >= ( optional const& x, optional const& y ) template inline bool operator == ( optional const& x, T const& y ) -{ return equal_pointees(x, optional(y)); } +{ return x && (*x == y); } template inline bool operator < ( optional const& x, T const& y ) -{ return less_pointees(x, optional(y)); } +{ return (!x) || (*x < y); } template inline @@ -94,12 +95,12 @@ bool operator >= ( optional const& x, T const& y ) template inline bool operator == ( T const& x, optional const& y ) -{ return equal_pointees( optional(x), y ); } +{ return y && (x == *y); } template inline bool operator < ( T const& x, optional const& y ) -{ return less_pointees( optional(x), y ); } +{ return y && (x < *y); } template inline @@ -134,7 +135,7 @@ bool operator == ( optional const& x, none_t ) BOOST_NOEXCEPT template inline bool operator < ( optional const& x, none_t ) -{ return less_pointees(x,optional() ); } +{ return false; } template inline @@ -168,7 +169,7 @@ bool operator == ( none_t , optional const& y ) BOOST_NOEXCEPT template inline bool operator < ( none_t , optional const& y ) -{ return less_pointees(optional() ,y); } +{ return bool(y); } template inline @@ -193,4 +194,3 @@ bool operator >= ( none_t x, optional const& y ) } // namespace boost #endif // header guard - diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 22221d29..57ff8ef0 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -59,7 +59,6 @@ #include #include #include -#include #include #include From 794e03af308cf714f3852a496bb741b188c55a23 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 15 Aug 2024 10:43:43 +0200 Subject: [PATCH 121/163] Drop dependency on Boost.Predef --- CMakeLists.txt | 2 -- doc/90_dependencies.qbk | 1 - doc/91_relnotes.qbk | 1 + include/boost/optional/detail/experimental_traits.hpp | 1 - test/optional_xconfig_HACK_TO_LIST_PREDEFINED_MACROS.cpp | 6 +++--- 5 files changed, 4 insertions(+), 7 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index aba836f8..0d5a858c 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -18,11 +18,9 @@ target_link_libraries(boost_optional Boost::config Boost::core Boost::move - Boost::predef Boost::static_assert Boost::throw_exception Boost::type_traits - Boost::utility ) if(BUILD_TESTING AND EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/test/CMakeLists.txt") diff --git a/doc/90_dependencies.qbk b/doc/90_dependencies.qbk index d033b08a..e0beee32 100644 --- a/doc/90_dependencies.qbk +++ b/doc/90_dependencies.qbk @@ -18,7 +18,6 @@ The implementation uses the following other Boost modules: # config # core # move -# predef # static_assert # throw_exception # type_traits diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index 9307a242..8b1a9e84 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -15,6 +15,7 @@ * *Breaking change.* Dropped support for C++03. C++11 is now the required minimum. * Dropped dependency on Boost.Utility. +* Dropped dependency on Boost.Predef. * A bit faster implementation of some relational operations. diff --git a/include/boost/optional/detail/experimental_traits.hpp b/include/boost/optional/detail/experimental_traits.hpp index 56670346..24df6233 100644 --- a/include/boost/optional/detail/experimental_traits.hpp +++ b/include/boost/optional/detail/experimental_traits.hpp @@ -14,7 +14,6 @@ #include #include -#include #include // The condition to use POD implementation diff --git a/test/optional_xconfig_HACK_TO_LIST_PREDEFINED_MACROS.cpp b/test/optional_xconfig_HACK_TO_LIST_PREDEFINED_MACROS.cpp index 202c7ef9..a3e7a680 100644 --- a/test/optional_xconfig_HACK_TO_LIST_PREDEFINED_MACROS.cpp +++ b/test/optional_xconfig_HACK_TO_LIST_PREDEFINED_MACROS.cpp @@ -11,7 +11,7 @@ #include "boost/core/lightweight_test.hpp" #include "boost/optional/detail/optional_config.hpp" -#include "boost/predef.h" +//#include "boost/predef.h" #include int main() @@ -19,13 +19,13 @@ int main() #if defined(__GNUC__) std::string emptys; - + #ifdef BOOST_INTEL_CXX_VERSION BOOST_TEST_EQ(emptys, "HAS INTEL INSIDE"); #else BOOST_TEST_EQ(emptys, "NO INTEL INSIDE"); #endif - + #if !defined BOOST_NO_CXX11_RVALUE_REFERENCES BOOST_TEST_EQ(emptys, "HAS RVALUE REFS"); #else From 6ec468aff6d8dea7b0fcc52962fbe6bf90e4511f Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 15 Aug 2024 10:57:03 +0200 Subject: [PATCH 122/163] Drop explicit bool idiom --- include/boost/optional/detail/optional_reference_spec.hpp | 3 +-- include/boost/optional/optional.hpp | 1 - test/optional_test_convert_assign.cpp | 3 +-- 3 files changed, 2 insertions(+), 5 deletions(-) diff --git a/include/boost/optional/detail/optional_reference_spec.hpp b/include/boost/optional/detail/optional_reference_spec.hpp index 3be3d330..4940a460 100644 --- a/include/boost/optional/detail/optional_reference_spec.hpp +++ b/include/boost/optional/detail/optional_reference_spec.hpp @@ -160,8 +160,7 @@ class optional : public optional_detail::optional_tag throw_exception(bad_optional_access()); } - bool operator!() const BOOST_NOEXCEPT { return ptr_ == 0; } - BOOST_EXPLICIT_OPERATOR_BOOL_NOEXCEPT() + explicit operator bool() const BOOST_NOEXCEPT { return ptr_ != 0; } void reset() BOOST_NOEXCEPT { ptr_ = 0; } diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 57ff8ef0..72fbd608 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -29,7 +29,6 @@ #include #include #include -#include #include #include #include diff --git a/test/optional_test_convert_assign.cpp b/test/optional_test_convert_assign.cpp index f0366dcf..5e1cedac 100644 --- a/test/optional_test_convert_assign.cpp +++ b/test/optional_test_convert_assign.cpp @@ -25,8 +25,7 @@ struct implicit_bool_conv struct explicit_bool_conv { - bool operator!() const BOOST_NOEXCEPT { return false; } - BOOST_EXPLICIT_OPERATOR_BOOL_NOEXCEPT() + explicit operator bool() const BOOST_NOEXCEPT { return true; } }; template From 27309c40adb08eb1f1da363328eda256978ea174 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 15 Aug 2024 11:13:44 +0200 Subject: [PATCH 123/163] Drop unused traits --- .../optional/detail/experimental_traits.hpp | 25 ------------------- 1 file changed, 25 deletions(-) diff --git a/include/boost/optional/detail/experimental_traits.hpp b/include/boost/optional/detail/experimental_traits.hpp index 24df6233..3776551f 100644 --- a/include/boost/optional/detail/experimental_traits.hpp +++ b/include/boost/optional/detail/experimental_traits.hpp @@ -52,14 +52,6 @@ #endif -#ifndef BOOST_OPTIONAL_DETAIL_USE_STD_TYPE_TRAITS -# define BOOST_OPTIONAL_DETAIL_HAS_TRIVIAL_CTOR(T) BOOST_HAS_TRIVIAL_CONSTRUCTOR(T) -#else -# include -# define BOOST_OPTIONAL_DETAIL_HAS_TRIVIAL_CTOR(T) std::is_trivially_default_constructible::value -#endif - - namespace boost { namespace optional_detail { #ifndef BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES @@ -81,23 +73,6 @@ struct is_type_trivially_copyable #endif - -#ifndef BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES -template -struct optional_uses_direct_storage_for_ - : boost::conditional< (is_type_trivially_copyable::value && BOOST_OPTIONAL_DETAIL_HAS_TRIVIAL_CTOR(T)) || - (boost::is_scalar::value && !boost::is_const::value && !boost::is_volatile::value) - , boost::true_type, boost::false_type>::type -{}; -#else -template -struct optional_uses_direct_storage_for_ - : boost::conditional<(boost::is_scalar::value && !boost::is_const::value && !boost::is_volatile::value) - , boost::true_type, boost::false_type>::type -{}; -#endif - - }} // boost::optional_detail #endif From 346dc03746d71ac7223cc1d150df877b7843a4f7 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 15 Aug 2024 11:42:42 +0200 Subject: [PATCH 124/163] Reimplement trivially semiregular trait --- .../optional/detail/experimental_traits.hpp | 23 +----- include/boost/optional/optional.hpp | 4 -- test/optional_test_experimental_traits.cpp | 70 +++++++++---------- test/optional_test_static_properties.cpp | 56 +++++++-------- 4 files changed, 65 insertions(+), 88 deletions(-) diff --git a/include/boost/optional/detail/experimental_traits.hpp b/include/boost/optional/detail/experimental_traits.hpp index 3776551f..4d4abe8b 100644 --- a/include/boost/optional/detail/experimental_traits.hpp +++ b/include/boost/optional/detail/experimental_traits.hpp @@ -12,8 +12,6 @@ #ifndef BOOST_OPTIONAL_DETAIL_EXPERIMENTAL_TRAITS_04NOV2017_HPP #define BOOST_OPTIONAL_DETAIL_EXPERIMENTAL_TRAITS_04NOV2017_HPP -#include -#include #include // The condition to use POD implementation @@ -22,8 +20,6 @@ # define BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES #elif defined BOOST_OPTIONAL_CONFIG_NO_SPEC_FOR_TRIVIAL_TYPES # define BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES -#elif !defined BOOST_HAS_TRIVIAL_CONSTRUCTOR -# define BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES #elif !defined BOOST_HAS_TRIVIAL_MOVE_ASSIGN # define BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES #elif !defined BOOST_HAS_TRIVIAL_MOVE_CONSTRUCTOR @@ -34,21 +30,6 @@ # define BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES #elif !defined BOOST_HAS_TRIVIAL_DESTRUCTOR # define BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES -#elif BOOST_WORKAROUND(BOOST_GCC, < 50000) -# define BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES -#endif - -// GCC 5 or higher, or clang with libc++ or clang with libstdc++ 5 or higher -#if __cplusplus >= 201103L -# if BOOST_WORKAROUND(BOOST_GCC, >= 50000) -# define BOOST_OPTIONAL_DETAIL_USE_STD_TYPE_TRAITS -# elif (defined BOOST_CLANG) -# if BOOST_LIB_STD_CXX > 0 -# define BOOST_OPTIONAL_DETAIL_USE_STD_TYPE_TRAITS -# elif BOOST_LIB_STD_GNU >= 441200023 && BOOST_LIB_STD_GNU != 450600023 && BOOST_LIB_STD_GNU != 450600026 && BOOST_LIB_STD_GNU != 460800003 && BOOST_LIB_STD_GNU != 450400026 && BOOST_LIB_STD_GNU != 460700026 -# define BOOST_OPTIONAL_DETAIL_USE_STD_TYPE_TRAITS -# endif -# endif #endif @@ -56,7 +37,7 @@ namespace boost { namespace optional_detail { #ifndef BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES template -struct is_type_trivially_copyable +struct is_trivially_semiregular : boost::conditional<(boost::has_trivial_copy_constructor::value && boost::has_trivial_move_constructor::value && boost::has_trivial_destructor::value && @@ -66,7 +47,7 @@ struct is_type_trivially_copyable {}; #else template -struct is_type_trivially_copyable +struct is_trivially_semiregular : boost::conditional<(boost::is_scalar::value && !boost::is_const::value && !boost::is_volatile::value), boost::true_type, boost::false_type>::type {}; diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 72fbd608..393eb43c 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -22,10 +22,6 @@ #include #endif // BOOST_NO_IOSTREAM -#ifdef BOOST_OPTIONAL_DETAIL_USE_STD_TYPE_TRAITS -# include -#endif - #include #include #include diff --git a/test/optional_test_experimental_traits.cpp b/test/optional_test_experimental_traits.cpp index 5088b4a2..eb8a736b 100644 --- a/test/optional_test_experimental_traits.cpp +++ b/test/optional_test_experimental_traits.cpp @@ -43,9 +43,9 @@ struct DeletedDefault }; namespace boost { namespace optional_config { - + template <> struct optional_uses_direct_storage_for : boost::true_type {}; - + }} struct CustDtor @@ -78,47 +78,47 @@ void test_type_traits() // this only tests if type traits are implemented correctly BOOST_TEST_TRAIT_TRUE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_TRUE(( boost::optional_config::optional_uses_direct_storage_for )); - + BOOST_TEST_TRAIT_TRUE(( boost::optional_config::optional_uses_direct_storage_for )); - + BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for > )); - + BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for > )); - - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable )); - + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular )); + + #ifndef BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES BOOST_TEST_TRAIT_TRUE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_TRUE(( boost::optional_config::optional_uses_direct_storage_for > )); BOOST_TEST_TRAIT_TRUE(( boost::optional_config::optional_uses_direct_storage_for, double> > )); - - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable > )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable, double> > )); - - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable > )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable > )); -#endif + + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular > )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular, double> > )); + + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular > )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular > )); +#endif BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for > )); - - BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_type_trivially_copyable )); - BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_type_trivially_copyable )); - BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_type_trivially_copyable )); - BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_type_trivially_copyable > )); + + BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_trivially_semiregular )); + BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_trivially_semiregular )); + BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_trivially_semiregular )); + BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_trivially_semiregular > )); } void test_trivial_copyability() @@ -127,16 +127,16 @@ void test_trivial_copyability() BOOST_TEST_TRAIT_TRUE((boost::is_base_of, boost::optional > )); BOOST_TEST_TRAIT_TRUE((boost::is_base_of, boost::optional > )); BOOST_TEST_TRAIT_FALSE((boost::is_base_of, boost::optional > )); - + #ifndef BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable > )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable > )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable > )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable > )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable > > )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable, double> > > )); - - BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_type_trivially_copyable > )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular > )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular > )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular > )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular > )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular > > )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular, double> > > )); + + BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_trivially_semiregular > )); #endif } diff --git a/test/optional_test_static_properties.cpp b/test/optional_test_static_properties.cpp index 5dc10537..90cd643d 100644 --- a/test/optional_test_static_properties.cpp +++ b/test/optional_test_static_properties.cpp @@ -43,9 +43,9 @@ struct DeletedDefault }; namespace boost { namespace optional_config { - + template <> struct optional_uses_direct_storage_for : boost::true_type {}; - + }} struct CustDtor @@ -78,40 +78,40 @@ void test_type_traits() // this only tests if type traits are implemented correctly BOOST_TEST_TRAIT_TRUE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_TRUE(( boost::optional_config::optional_uses_direct_storage_for )); - + BOOST_TEST_TRAIT_TRUE(( boost::optional_config::optional_uses_direct_storage_for )); - + BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for > )); - + BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for > )); - - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable )); + + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for > )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for, double> > )); #ifndef BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES - - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable > )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable, double> > )); - -#endif + + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular > )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular, double> > )); + +#endif BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for )); BOOST_TEST_TRAIT_FALSE(( boost::optional_config::optional_uses_direct_storage_for > )); - - BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_type_trivially_copyable )); - BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_type_trivially_copyable )); - BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_type_trivially_copyable )); - BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_type_trivially_copyable > )); + + BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_trivially_semiregular )); + BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_trivially_semiregular )); + BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_trivially_semiregular )); + BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_trivially_semiregular > )); } void test_trivial_copyability() @@ -120,18 +120,18 @@ void test_trivial_copyability() BOOST_TEST_TRAIT_TRUE((boost::is_base_of, boost::optional > )); BOOST_TEST_TRAIT_TRUE((boost::is_base_of, boost::optional > )); BOOST_TEST_TRAIT_FALSE((boost::is_base_of, boost::optional > )); - + #ifndef BOOST_OPTIONAL_DETAIL_NO_SPEC_FOR_TRIVIAL_TYPES - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable > )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable > )); - BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_type_trivially_copyable > )); - - BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_type_trivially_copyable > )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular > )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular > )); + BOOST_TEST_TRAIT_TRUE(( boost::optional_detail::is_trivially_semiregular > )); + + BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_trivially_semiregular > )); #endif - BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_type_trivially_copyable > )); - BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_type_trivially_copyable > > )); - BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_type_trivially_copyable, double> > > )); + BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_trivially_semiregular > )); + BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_trivially_semiregular > > )); + BOOST_TEST_TRAIT_FALSE(( boost::optional_detail::is_trivially_semiregular, double> > > )); } #endif From e360de3da52cc3f5fca7347354d969d996150c53 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 15 Aug 2024 11:48:28 +0200 Subject: [PATCH 125/163] Header cleanup --- include/boost/optional/optional.hpp | 1 - 1 file changed, 1 deletion(-) diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 393eb43c..979ebcc2 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -30,7 +30,6 @@ #include #include #include -#include #include #include #include From 411ead088dadd0518bc52161ed87176113167252 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 15 Aug 2024 21:41:17 +0200 Subject: [PATCH 126/163] Different implementation of map and flat_map --- .../detail/optional_reference_spec.hpp | 7 +-- include/boost/optional/optional.hpp | 44 ++++++++++++++----- 2 files changed, 38 insertions(+), 13 deletions(-) diff --git a/include/boost/optional/detail/optional_reference_spec.hpp b/include/boost/optional/detail/optional_reference_spec.hpp index 4940a460..9cb2b5c1 100644 --- a/include/boost/optional/detail/optional_reference_spec.hpp +++ b/include/boost/optional/detail/optional_reference_spec.hpp @@ -168,7 +168,8 @@ class optional : public optional_detail::optional_tag bool has_value() const BOOST_NOEXCEPT { return ptr_ != 0; } template - auto map(F f) const -> optional + optional::type> + map(F f) const { if (this->has_value()) return f(this->get()); @@ -177,8 +178,8 @@ class optional : public optional_detail::optional_tag } template - auto flat_map(F f) const -> - optional::type> + optional::type> + flat_map(F f) const { if (this->has_value()) return f(get()); diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 979ebcc2..6be45355 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -76,6 +76,23 @@ struct optional_value_type< ::boost::optional > template T declval(); + +// implementing my own result_of so that it works for C++11 (std::result_of) +// and in C++20 (std::invoke_result). +template ()(declval()))> +struct result_of +{ + typedef Rslt type; +}; + +template ::type>::type> +struct result_value_type +{ + typedef Rslt type; +}; + +// optional()(optional_detail::declval()))>::type> + }} // namespace boost::optional_detail namespace boost { @@ -1396,7 +1413,7 @@ class optional } template - optional()(optional_detail::declval()))> map(F f) & + optional::type> map(F f) & { if (this->has_value()) return f(get()); @@ -1405,7 +1422,7 @@ class optional } template - optional()(optional_detail::declval()))> map(F f) const& + optional::type> map(F f) const& { if (this->has_value()) return f(get()); @@ -1414,7 +1431,7 @@ class optional } template - optional()(optional_detail::declval()))> map(F f) && + optional::type> map(F f) && { if (this->has_value()) return f(boost::move(this->get())); @@ -1423,7 +1440,8 @@ class optional } template - optional()(optional_detail::declval()))>::type> flat_map(F f) & + optional::type> + flat_map(F f) & { if (this->has_value()) return f(get()); @@ -1432,7 +1450,8 @@ class optional } template - optional()(optional_detail::declval()))>::type>flat_map(F f) const& + optional::type> + flat_map(F f) const& { if (this->has_value()) return f(get()); @@ -1441,7 +1460,8 @@ class optional } template - optional()(optional_detail::declval()))>::type>flat_map(F f) && + optional::type> + flat_map(F f) && { if (this->has_value()) return f(boost::move(get())); @@ -1460,7 +1480,8 @@ class optional } template - optional()(optional_detail::declval()))> map(F f) + optional::type> + map(F f) { if (this->has_value()) return f(get()); @@ -1469,7 +1490,8 @@ class optional } template - optional()(optional_detail::declval()))> map(F f) const + optional::type> + map(F f) const { if (this->has_value()) return f(get()); @@ -1478,7 +1500,8 @@ class optional } template - optional()(optional_detail::declval()))>::type> flat_map(F f) + optional::type> + flat_map(F f) { if (this->has_value()) return f(get()); @@ -1487,7 +1510,8 @@ class optional } template - optional()(optional_detail::declval()))>::type> flat_map(F f) const + optional::type> + flat_map(F f) const { if (this->has_value()) return f(get()); From 36c33f2e6726ffa3cb36b126781c1bbaa166041b Mon Sep 17 00:00:00 2001 From: Alexander Grund Date: Fri, 16 Aug 2024 10:37:12 +0200 Subject: [PATCH 127/163] Fix ununsed parameter warning The function returns false w/o using any parameter leading to a warning. Remove the name from the parameter --- include/boost/optional/detail/optional_relops.hpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/include/boost/optional/detail/optional_relops.hpp b/include/boost/optional/detail/optional_relops.hpp index c7766fc9..dc558ea6 100644 --- a/include/boost/optional/detail/optional_relops.hpp +++ b/include/boost/optional/detail/optional_relops.hpp @@ -134,7 +134,7 @@ bool operator == ( optional const& x, none_t ) BOOST_NOEXCEPT template inline -bool operator < ( optional const& x, none_t ) +bool operator < ( optional const&, none_t ) { return false; } template From e1a3501a78e85bb83bbfe0448ce229add4b24e32 Mon Sep 17 00:00:00 2001 From: Alexander Grund Date: Fri, 16 Aug 2024 10:52:32 +0200 Subject: [PATCH 128/163] Rename test_equals_none to test_cmp_none In order to add more tests the new name is more fitting. --- test/Jamfile.v2 | 2 +- ...optional_test_equals_none.cpp => optional_test_cmp_none.cpp} | 0 2 files changed, 1 insertion(+), 1 deletion(-) rename test/{optional_test_equals_none.cpp => optional_test_cmp_none.cpp} (100%) diff --git a/test/Jamfile.v2 b/test/Jamfile.v2 index 00bf1528..de84f2ec 100644 --- a/test/Jamfile.v2 +++ b/test/Jamfile.v2 @@ -42,7 +42,7 @@ run optional_test_inplace_factory.cpp ; run optional_test_io.cpp ; run optional_test_move.cpp ; run optional_test_noexcept_move.cpp ; -run optional_test_equals_none.cpp ; +run optional_test_cmp_none.cpp ; run optional_test_value_access.cpp ; run optional_test_emplace.cpp ; run optional_test_minimum_requirements.cpp ; diff --git a/test/optional_test_equals_none.cpp b/test/optional_test_cmp_none.cpp similarity index 100% rename from test/optional_test_equals_none.cpp rename to test/optional_test_cmp_none.cpp From 5fa59b9a3533a017dd30c9536255252c253f229c Mon Sep 17 00:00:00 2001 From: Alexander Grund Date: Fri, 16 Aug 2024 11:13:45 +0200 Subject: [PATCH 129/163] Add test for all relational operators to `boost::none` --- test/optional_test_cmp_none.cpp | 40 +++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/test/optional_test_cmp_none.cpp b/test/optional_test_cmp_none.cpp index 1e3157b1..691517b9 100644 --- a/test/optional_test_cmp_none.cpp +++ b/test/optional_test_cmp_none.cpp @@ -1,4 +1,5 @@ // Copyright (C) 2014 Andrzej Krzemienski. +// Copyright (C) 2024 Alexander Grund // // Use, modification, and distribution is subject to the Boost Software // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at @@ -36,6 +37,45 @@ void test_equal_to_none_of_noncomparable_T() BOOST_TEST(boost::none == o); } +void test_comparison_to_none() +{ + using boost::none; + boost::optional i = SemiRegular(); + // the default ordering of optional is{ boost::none, 0, 1, 2, ... } + // Hence boost::none < i for any engaged i + // and all others operators ( ==, !=, <, <=, >, >= ) follow + + BOOST_TEST(!(i == none)); + BOOST_TEST(i != none); + BOOST_TEST(!(i < none)); + BOOST_TEST(!(i <= none)); + BOOST_TEST(i > none); + BOOST_TEST(i >= none); + // Comparison is symmetric + BOOST_TEST(!(none == i)); + BOOST_TEST(none != i); + BOOST_TEST(none < i); + BOOST_TEST(none <= i); + BOOST_TEST(!(none > i)); + BOOST_TEST(!(none >= i)); + + // An un-engaged optional is always equal to none + boost::optional o; + BOOST_TEST(o == none); + BOOST_TEST(!(o != none)); + BOOST_TEST(!(o < none)); + BOOST_TEST(o <= none); + BOOST_TEST(!(o > none)); + BOOST_TEST(o >= none); + // Comparison is symmetric + BOOST_TEST(none == o); + BOOST_TEST(!(none != o)); + BOOST_TEST(!(none < o)); + BOOST_TEST(none <= o); + BOOST_TEST(!(none > o)); + BOOST_TEST(none >= o); +} + int main() { test_equal_to_none_of_noncomparable_T(); From c3b5267506b3a537d55e7a6f0ab82a41b022d431 Mon Sep 17 00:00:00 2001 From: Alexander Grund Date: Fri, 16 Aug 2024 11:44:10 +0200 Subject: [PATCH 130/163] Add C++11 requirements to test Jamfile --- test/Jamfile.v2 | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/test/Jamfile.v2 b/test/Jamfile.v2 index 00bf1528..eb1255d9 100644 --- a/test/Jamfile.v2 +++ b/test/Jamfile.v2 @@ -2,6 +2,7 @@ # # Copyright (C) 2003, Fernando Luis Cacciola Carballal. # Copyright (C) 2014 - 2017 Andrzej Krzemienski +# Copyright (C) 2024 Alexander Grund # # Use, modification, and distribution is subject to the Boost Software # License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at @@ -13,8 +14,24 @@ # akrzemi1@gmail.com # +import config : requires ; import testing ; +project + : requirements + [ requires + cxx11_decltype + cxx11_defaulted_functions + cxx11_defaulted_moves + cxx11_deleted_functions + cxx11_explicit_conversion_operators + cxx11_noexcept + cxx11_rvalue_references + cxx11_variadic_templates + ] + ; + + run optional_test.cpp ; run optional_test_assign.cpp ; run optional_test_swap.cpp ; From ce03067859f472a62c594f97414c85ba837edd46 Mon Sep 17 00:00:00 2001 From: Alexander Grund Date: Fri, 16 Aug 2024 11:45:19 +0200 Subject: [PATCH 131/163] Add C++11 requirement to CMake --- CMakeLists.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/CMakeLists.txt b/CMakeLists.txt index 0d5a858c..976738b5 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -22,6 +22,7 @@ target_link_libraries(boost_optional Boost::throw_exception Boost::type_traits ) +target_compile_features(boost_optional INTERFACE cxx_std_11) if(BUILD_TESTING AND EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/test/CMakeLists.txt") From c6657cc9bd0d36b02eacfa2aa84a16ec44afa804 Mon Sep 17 00:00:00 2001 From: Alexander Grund Date: Fri, 16 Aug 2024 11:53:47 +0200 Subject: [PATCH 132/163] GHA: Fix node version issue Avoid > /__e/node20/bin/node: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.28' not found (required by /__e/node20/bin/node) See https://github.com/actions/checkout/issues/1590 --- .github/workflows/ci.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 279a7100..72316f23 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -10,6 +10,7 @@ on: env: UBSAN_OPTIONS: print_stacktrace=1 + ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION: true jobs: posix: From 8ecf840c33866ea181aade13a5e9b92e73aba986 Mon Sep 17 00:00:00 2001 From: Alexander Grund Date: Fri, 16 Aug 2024 12:07:55 +0200 Subject: [PATCH 133/163] GHA: Use Ubuntu 22.04 for G++11 --- .github/workflows/ci.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 72316f23..05bdc146 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -59,7 +59,7 @@ jobs: address-model: 32,64 - toolset: gcc-11 cxxstd: "03,11,14,17,20" - os: ubuntu-20.04 + os: ubuntu-22.04 install: g++-11-multilib address-model: 32,64 - toolset: gcc-12 From cbc7014edfa7349395b045935d3e7453e832ae75 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Sat, 17 Aug 2024 00:12:45 +0200 Subject: [PATCH 134/163] updated libraries.json --- meta/libraries.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/meta/libraries.json b/meta/libraries.json index a263d7e8..0d1fced4 100644 --- a/meta/libraries.json +++ b/meta/libraries.json @@ -13,5 +13,5 @@ "Fernando Cacciola ", "Andrzej Krzemienski " ], - "cxxstd": "03" + "cxxstd": "11" } From 824552dc5f56e259447cb82ecf76f3aef9e97f44 Mon Sep 17 00:00:00 2001 From: Alexander Grund Date: Sun, 25 Aug 2024 14:43:47 +0200 Subject: [PATCH 135/163] GHA: Remove macos-11 jobs The runners no longer have that so the jobs fail as they never start --- .github/workflows/ci.yml | 6 ------ 1 file changed, 6 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 05bdc146..e8ad7c7e 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -153,9 +153,6 @@ jobs: container: ubuntu:23.10 os: ubuntu-latest install: clang-17 - - toolset: clang - cxxstd: "03,11,14,17,2a" - os: macos-11 - toolset: clang cxxstd: "03,11,14,17,20,2b" os: macos-12 @@ -283,7 +280,6 @@ jobs: include: - os: ubuntu-20.04 - os: ubuntu-22.04 - - os: macos-11 - os: macos-12 - os: macos-13 @@ -331,7 +327,6 @@ jobs: include: - os: ubuntu-20.04 - os: ubuntu-22.04 - - os: macos-11 - os: macos-12 - os: macos-13 @@ -389,7 +384,6 @@ jobs: include: - os: ubuntu-20.04 - os: ubuntu-22.04 - - os: macos-11 - os: macos-12 - os: macos-13 From 4ce395e14d177adc5432daf6af1746f9bc3b72e0 Mon Sep 17 00:00:00 2001 From: Rene Rivera Date: Sat, 31 Aug 2024 14:09:34 -0500 Subject: [PATCH 136/163] Update build deps. --- build.jam | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/build.jam b/build.jam index 91e6606b..5c8089b5 100644 --- a/build.jam +++ b/build.jam @@ -10,19 +10,14 @@ constant boost_dependencies : /boost/config//boost_config /boost/core//boost_core /boost/move//boost_move - /boost/predef//boost_predef /boost/static_assert//boost_static_assert /boost/throw_exception//boost_throw_exception - /boost/type_traits//boost_type_traits - /boost/utility//boost_utility ; + /boost/type_traits//boost_type_traits ; -project /boost/optional - : common-requirements - include - ; +project /boost/optional ; explicit - [ alias boost_optional : : : : $(boost_dependencies) ] + [ alias boost_optional : : : : $(boost_dependencies) include ] [ alias all : boost_optional test ] ; From cbfb66379bd2b5ef5fc03cfb5ef370793a47dfe6 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Fri, 13 Sep 2024 16:22:40 +0200 Subject: [PATCH 137/163] Tags in_place_init and in_place_init_if become inline constexpr --- doc/27_ref_optional_synopsis.qbk | 4 ++-- doc/91_relnotes.qbk | 1 + include/boost/none.hpp | 2 +- include/boost/optional/optional.hpp | 8 ++++---- 4 files changed, 8 insertions(+), 7 deletions(-) diff --git a/doc/27_ref_optional_synopsis.qbk b/doc/27_ref_optional_synopsis.qbk index d86967bd..d0df811c 100644 --- a/doc/27_ref_optional_synopsis.qbk +++ b/doc/27_ref_optional_synopsis.qbk @@ -16,10 +16,10 @@ namespace boost { class in_place_init_t { /* see below */ } ; ``[link reference_in_place_init __GO_TO__]`` - const in_place_init_t in_place_init ( /* see below */ ) ; + inline constexpr in_place_init_t in_place_init ( /* see below */ ) ; class in_place_init_if_t { /*see below*/ } ; ``[link reference_in_place_init_if __GO_TO__]`` - const in_place_init_if_t in_place_init_if ( /*see below*/ ) ; + inline constexpr in_place_init_if_t in_place_init_if ( /*see below*/ ) ; template class optional ; ``[link reference_operator_template __GO_TO__]`` diff --git a/doc/91_relnotes.qbk b/doc/91_relnotes.qbk index 8b1a9e84..ed16e736 100644 --- a/doc/91_relnotes.qbk +++ b/doc/91_relnotes.qbk @@ -17,6 +17,7 @@ * Dropped dependency on Boost.Utility. * Dropped dependency on Boost.Predef. * A bit faster implementation of some relational operations. +* Tags `in_place_init` and `in_place_init_if` become `inline constexpr` and therewith leave smaller footprint in the executable. This addresses [@https://github.com/boostorg/optional/issues/103 issue #103]. [heading Boost Release 1.85] diff --git a/include/boost/none.hpp b/include/boost/none.hpp index 5f927cc3..3e7a9500 100644 --- a/include/boost/none.hpp +++ b/include/boost/none.hpp @@ -50,7 +50,7 @@ namespace { #else -BOOST_INLINE_VARIABLE BOOST_CONSTEXPR_OR_CONST none_t none ((none_t::init_tag())); +BOOST_INLINE_CONSTEXPR none_t none ((none_t::init_tag())); #endif // older definitions diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 6be45355..df3c8a38 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -103,17 +103,17 @@ namespace optional_ns { struct in_place_init_t { struct init_tag{}; - explicit in_place_init_t(init_tag){} + BOOST_CONSTEXPR explicit in_place_init_t(init_tag){} }; -const in_place_init_t in_place_init ((in_place_init_t::init_tag())); +BOOST_INLINE_CONSTEXPR in_place_init_t in_place_init ((in_place_init_t::init_tag())); // a tag for conditional in-place initialization of contained value struct in_place_init_if_t { struct init_tag{}; - explicit in_place_init_if_t(init_tag){} + BOOST_CONSTEXPR explicit in_place_init_if_t(init_tag){} }; -const in_place_init_if_t in_place_init_if ((in_place_init_if_t::init_tag())); +BOOST_INLINE_CONSTEXPR in_place_init_if_t in_place_init_if ((in_place_init_if_t::init_tag())); } // namespace optional_ns From 07b689fc3e324f0eae12eff51741f6b590c94796 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Sat, 14 Sep 2024 01:08:05 +0200 Subject: [PATCH 138/163] Document differences form std --- doc/00_optional.qbk | 5 ++- doc/91_comparison_with_std.qbk | 44 +++++++++++++++++++ doc/{91_relnotes.qbk => 92_relnotes.qbk} | 0 ...owledgments.qbk => 93_acknowledgments.qbk} | 0 4 files changed, 47 insertions(+), 2 deletions(-) create mode 100644 doc/91_comparison_with_std.qbk rename doc/{91_relnotes.qbk => 92_relnotes.qbk} (100%) rename doc/{92_acknowledgments.qbk => 93_acknowledgments.qbk} (100%) diff --git a/doc/00_optional.qbk b/doc/00_optional.qbk index 093df84f..2fa23576 100644 --- a/doc/00_optional.qbk +++ b/doc/00_optional.qbk @@ -101,5 +101,6 @@ This is how you solve it with `boost::optional`: [include 29_ref_optional_convenience.qbk] [endsect] [include 90_dependencies.qbk] -[include 91_relnotes.qbk] -[include 92_acknowledgments.qbk] +[include 91_comparison_with_std.qbk] +[include 92_relnotes.qbk] +[include 93_acknowledgments.qbk] diff --git a/doc/91_comparison_with_std.qbk b/doc/91_comparison_with_std.qbk new file mode 100644 index 00000000..5d631d6c --- /dev/null +++ b/doc/91_comparison_with_std.qbk @@ -0,0 +1,44 @@ +[/ + Boost.Optional + + Copyright (c) 2015 - 2024 Andrzej Krzemieński + + Distributed under the Boost Software License, Version 1.0. + (See accompanying file LICENSE_1_0.txt or copy at + http://www.boost.org/LICENSE_1_0.txt) +] + + +[section:std_comp Comparison with `std::optional`] + +[table + [] + [ [[*`boost::opitonal`]] [[*`std::optional`]] [] ] + [ [`optional o = none;`] [`optional o = nullopt;`] [Different name for no-value tag.] ] + [ [`optional o {in_place_init, a, b};`] [`optional o {in_place, a, b};`] [Different name for in-place initialization tag.] ] + [ [] [`optional> o {in_place, {1, 2, 3}};`] [No in-place initialization with initializer-list in `boost`.] ] + [ [`optional o {in_place_init_if, cond, a, b};`] [] [No syntax for conditional in-place initialization in `std`.] ] + [ [`optional o {cond, x};`] [] [No syntax for conditional initialization from `T` in `std`.] ] + [ [`optional o {U{}};` + + `optional o {optional{}};`] [`optional o = U{};` + + `optional o = optional{}`] [Constructors form `U` and `optional` are explicit in `boost` and implicit in `std`.] ] + [ [`optional o;`] [] [No optional references in `std`.] ] + [ [] [`constexpr optional o;`] [No `constexpr` interface in `boost`.] ] + [ [`o.map(&f);` + + `o.flat_map(&of);` ] [`o.transform(&f);` + + `o.and_then(&of);`] [Different names and signatures for monadic interface functions. `boost` takes callbacks by value, `std` by universal reference.] ] + [ [] [`o.or_else(&of);`] [No `or_else` function in `boost`.] ] + [ [`o.value_or_eval(&f);`] [] [No `value_or_eval` function in `std`.] ] + [ [] [`optional{} == U{}`; + + `opitonal{} == opitonal{}`] [No comparisons with `U` or `optional` in `boost`.] ] + [ [`make_optional(cond, v);`] [] [No `make_optional` with condition in `std`.] ] + [ [] [`make_optional(a, b);`] [No `make_optional` with specified `T` in `boost`.] ] +] + + +[endsect][/ std_comp] diff --git a/doc/91_relnotes.qbk b/doc/92_relnotes.qbk similarity index 100% rename from doc/91_relnotes.qbk rename to doc/92_relnotes.qbk diff --git a/doc/92_acknowledgments.qbk b/doc/93_acknowledgments.qbk similarity index 100% rename from doc/92_acknowledgments.qbk rename to doc/93_acknowledgments.qbk From cb68f6053d6ae9477d1cc1bec11b28c22ce708d5 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Sat, 14 Sep 2024 14:51:54 +0200 Subject: [PATCH 139/163] mention CTAD in std comparison --- doc/91_comparison_with_std.qbk | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/doc/91_comparison_with_std.qbk b/doc/91_comparison_with_std.qbk index 5d631d6c..f407ab02 100644 --- a/doc/91_comparison_with_std.qbk +++ b/doc/91_comparison_with_std.qbk @@ -13,7 +13,7 @@ [table [] - [ [[*`boost::opitonal`]] [[*`std::optional`]] [] ] + [ [[*`boost::optional`]] [[*`std::optional`]] [] ] [ [`optional o = none;`] [`optional o = nullopt;`] [Different name for no-value tag.] ] [ [`optional o {in_place_init, a, b};`] [`optional o {in_place, a, b};`] [Different name for in-place initialization tag.] ] [ [] [`optional> o {in_place, {1, 2, 3}};`] [No in-place initialization with initializer-list in `boost`.] ] @@ -24,6 +24,7 @@ `optional o {optional{}};`] [`optional o = U{};` `optional o = optional{}`] [Constructors form `U` and `optional` are explicit in `boost` and implicit in `std`.] ] + [ [] [`optional o = 1;`] [No clever deduction of of `optional`'s template parameters in initialization in `boost`. ]] [ [`optional o;`] [] [No optional references in `std`.] ] [ [] [`constexpr optional o;`] [No `constexpr` interface in `boost`.] ] [ [`o.map(&f);` @@ -35,7 +36,7 @@ [ [`o.value_or_eval(&f);`] [] [No `value_or_eval` function in `std`.] ] [ [] [`optional{} == U{}`; - `opitonal{} == opitonal{}`] [No comparisons with `U` or `optional` in `boost`.] ] + `optional{} == optional{}`] [No comparisons with `U` or `optional` in `boost`.] ] [ [`make_optional(cond, v);`] [] [No `make_optional` with condition in `std`.] ] [ [] [`make_optional(a, b);`] [No `make_optional` with specified `T` in `boost`.] ] ] From f97e43ce13fa1dd8d145b7e242ae31a2e03d80f4 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Sun, 15 Sep 2024 21:12:34 +0200 Subject: [PATCH 140/163] update docs for comparison with std --- doc/91_comparison_with_std.qbk | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/doc/91_comparison_with_std.qbk b/doc/91_comparison_with_std.qbk index f407ab02..e72dd46f 100644 --- a/doc/91_comparison_with_std.qbk +++ b/doc/91_comparison_with_std.qbk @@ -16,7 +16,9 @@ [ [[*`boost::optional`]] [[*`std::optional`]] [] ] [ [`optional o = none;`] [`optional o = nullopt;`] [Different name for no-value tag.] ] [ [`optional o {in_place_init, a, b};`] [`optional o {in_place, a, b};`] [Different name for in-place initialization tag.] ] - [ [] [`optional> o {in_place, {1, 2, 3}};`] [No in-place initialization with initializer-list in `boost`.] ] + [ [] [`optional> o {in_place, {1, 2, 3}};` + + `o.emplace({4, 5, 6});`] [No in-place initialization with initializer-list in `boost`.] ] [ [`optional o {in_place_init_if, cond, a, b};`] [] [No syntax for conditional in-place initialization in `std`.] ] [ [`optional o {cond, x};`] [] [No syntax for conditional initialization from `T` in `std`.] ] [ [`optional o {U{}};` @@ -39,6 +41,7 @@ `optional{} == optional{}`] [No comparisons with `U` or `optional` in `boost`.] ] [ [`make_optional(cond, v);`] [] [No `make_optional` with condition in `std`.] ] [ [] [`make_optional(a, b);`] [No `make_optional` with specified `T` in `boost`.] ] + [ [`std::cout << optional{};`] [] [No printing to IOStreams in `std`.]] ] From 1825c778eda2b859d17d1e49c5b0003c36e0da0a Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Wed, 18 Sep 2024 09:28:55 +0200 Subject: [PATCH 141/163] Improve docs Restructure. Rewrite old content. Add new page, on convenience functions --- doc/00_optional.qbk | 21 +- doc/01_quick_start.qbk | 81 +++-- doc/10_motivation.qbk | 80 ----- doc/11_development.qbk | 337 ++++++------------ ...rators.qbk => 12_relational_operators.qbk} | 0 doc/13_convenience.qbk | 102 ++++++ doc/14_monadic_interface.qbk | 45 --- doc/16_optional_references.qbk | 13 +- doc/1A_type_requirements.qbk | 8 +- doc/28_ref_optional_semantics.qbk | 6 +- ...{12_when_to_use.qbk => 31_when_to_use.qbk} | 0 ..._performance.qbk => 32_on_performance.qbk} | 0 doc/90_dependencies.qbk | 2 +- 13 files changed, 299 insertions(+), 396 deletions(-) delete mode 100644 doc/10_motivation.qbk rename doc/{13_relational_operators.qbk => 12_relational_operators.qbk} (100%) create mode 100644 doc/13_convenience.qbk delete mode 100644 doc/14_monadic_interface.qbk rename doc/{12_when_to_use.qbk => 31_when_to_use.qbk} (100%) rename doc/{1B_on_performance.qbk => 32_on_performance.qbk} (100%) diff --git a/doc/00_optional.qbk b/doc/00_optional.qbk index 2fa23576..4809c285 100644 --- a/doc/00_optional.qbk +++ b/doc/00_optional.qbk @@ -49,9 +49,15 @@ Distributed under the Boost Software License, Version 1.0. [def __SPACE__ [$images/space.png]] [def __GO_TO__ [$images/R.png]] +[/ Common terms ] + +[def __UB__ [@https://en.cppreference.com/w/cpp/language/ub ['undefined behavior]]] + [section Introduction] -Class template `optional` is a wrapper for representing 'optional' (or 'nullable') objects who may not (yet) contain a valid value. Optional objects offer full value semantics; they are good for passing by value and usage inside STL containers. This is a header-only library. +Class template `optional` is a wrapper for representing 'optional' (or 'nullable') +objects who may not (yet) contain a valid value. Optional objects offer full value semantics; +they are good for passing by value and usage inside STL containers. This is a header-only C++11 library. [heading Problem] Suppose we want to read a parameter from a config file which represents some integral value, let's call it `"MaxValue"`. It is possible that this parameter is not specified; such situation is no error. It is valid to not specify the parameter and in that case the program is supposed to behave slightly differently. Also, suppose that any possible value of type `int` is a valid value for `"MaxValue"`, so we cannot just use `-1` to represent the absence of the parameter in the config file. @@ -75,19 +81,16 @@ This is how you solve it with `boost::optional`: [endsect] [include 01_quick_start.qbk] -[section Tutorial] -[include 10_motivation.qbk] +[section:design Design Overview and Rationale] [include 11_development.qbk] -[include 12_when_to_use.qbk] -[include 13_relational_operators.qbk] -[include 14_monadic_interface.qbk] +[include 12_relational_operators.qbk] +[include 13_convenience.qbk] [include 15_io.qbk] [include 16_optional_references.qbk] [include 17_in_place_factories.qbk] [include 18_gotchas.qbk] [include 19_exception_safety.qbk] [include 1A_type_requirements.qbk] -[include 1B_on_performance.qbk] [endsect] [section:reference Reference] [include 21_ref_none.qbk] @@ -100,6 +103,10 @@ This is how you solve it with `boost::optional`: [endsect] [include 29_ref_optional_convenience.qbk] [endsect] +[section:advice Advice] +[include 31_when_to_use.qbk] +[include 32_on_performance.qbk] +[endsect] [include 90_dependencies.qbk] [include 91_comparison_with_std.qbk] [include 92_relnotes.qbk] diff --git a/doc/01_quick_start.qbk b/doc/01_quick_start.qbk index 223603dd..9d2c35de 100644 --- a/doc/01_quick_start.qbk +++ b/doc/01_quick_start.qbk @@ -10,16 +10,24 @@ ] -[section Quick Start] +[section Quick Overview] [section Optional return values] -Let's write and use a converter function that converts a `std::string` to an `int`. It is possible that for a given string (e.g. `"cat"`) there exists no value of type `int` capable of representing the conversion result. We do not consider such situation an error. We expect that the converter can be used only to check if the conversion is possible. A natural signature for this function can be: +Let's write and use a converter function that converts a `std::string` to an `int`. +It is possible that for a given string (e.g. `"cat"`) there exists no value of type +`int` capable of representing the conversion result. We do not consider such +situation an error. We expect that the converter can be used only to check if +the conversion is possible. A natural signature for this function can be: #include boost::optional convert(const std::string& text); -All necessary functionality can be included with one header ``. The above function signature means that the function can either return a value of type `int` or a flag indicating that no value of `int` is available. This does not indicate an error. It is like one additional value of `int`. This is how we can use our function: +All necessary functionality can be included with one header ``. +The above function signature means that the function can either return a value +of type `int` or a flag indicating that no value of `int` is available. +This does not indicate an error. It is like one additional value of `int`. +This is how we can use our function: const std::string& text = /*... */; boost::optional oi = convert(text); // move-construct @@ -116,29 +124,10 @@ Suppose we want to implement a ['lazy load] optimization. This is because we do `optional`'s default constructor creates an uninitialized optional. No call to `Resource`'s default constructor is attempted. `Resource` doesn't have to be __STD_DEFAULT_CONSTRUCTIBLE__. In function `getResource` we first check if `resource_` is initialized. This time we do not use the contextual conversion to `bool`, but a comparison with `boost::none`. These two ways are equivalent. Function `emplace` initializes the optional in-place by perfect-forwarding the arguments to the constructor of `Resource`. No copy- or move-construction is involved here. `Resource` doesn't even have to be `MoveConstructible`. -[note Function `emplace` is only available on compilers that support rvalue references and variadic templates. If your compiler does not support these features and you still need to avoid any move-constructions, use [link boost_optional.tutorial.in_place_factories In-Place Factories].] +[note Function `emplace` is only available on compilers that support rvalue references and variadic templates. If your compiler does not support these features and you still need to avoid any move-constructions, use [link boost_optional.design.in_place_factories In-Place Factories].] [endsect] -[section Bypassing unnecessary default construction] - -Suppose we have class `Date`, which does not have a default constructor: there is no good candidate for a default date. We have a function that returns two dates in form of a `boost::tuple`: - - boost::tuple getPeriod(); - -In other place we want to use the result of `getPeriod`, but want the two dates to be named: `begin` and `end`. We want to implement something like 'multiple return values': - - Date begin, end; // Error: no default ctor! - boost::tie(begin, end) = getPeriod(); - -The second line works already, this is the capability of __BOOST_TUPLE__ library, but the first line won't work. We could set some invented initial dates, but it is confusing and may be an unacceptable cost, given that these values will be overwritten in the next line anyway. This is where `optional` can help: - - boost::optional begin, end; - boost::tie(begin, end) = getPeriod(); - -It works because inside `boost::tie` a move-assignment from `T` is invoked on `optional`, which internally calls a move-constructor of `T`. -[endsect] - [section Storage in containers] Suppose you want to ask users to choose some number (an `int`). One of the valid responses is to choose nothing, which is represented by an uninitialized `optional`. You want to make a histogram showing how many times each choice was made. You can use an `std::map`: @@ -157,4 +146,50 @@ which is compared less than any value of `T`. as it provides specializations for `std::hash`. [endsect] +[section Monadic interface] + +The monadic interface of `optional` allows the application of functions +to optional values without resorting to the usage of explicit `if`-statements. + +Function `map` takes a function mapping type `T` onto type `U` and maps an `optional` +onto an `optional` using the provided function. + + int length(const string& s){ return s.size(); }; + + optional null{}, thin{""}, word{"word"}; + assert (null.map(length) == none); + assert (thin.map(length) == 0); + assert (word.map(length) == 4); + +Function `flat_map` is similar, but it requires the function to return an +`optional` for some type `V`. This `optional` becomes the return type of +`flat_map`. + + optional first_char(const string& s) { + if (s.empty()) return none; + else return s[0]; + }; + + optional null{}, thin{""}, word{"word"}; + assert (null.flat_map(first_char) == none); + assert (thin.flat_map(first_char) == none); + assert (word.flat_map(first_char) == 'w'); + +These functions can be combined in one expression reflecting a chain of computations: + + auto get_contents(path p) -> optional; + auto trim(string) -> string; + auto length(string) -> int; + + auto trimmed_size_of(optional p) -> int + { + return p.flat_map(get_contents) + .map(trim) + .map(length) + .value_or(0); + } + + +[endsect] + [endsect] diff --git a/doc/10_motivation.qbk b/doc/10_motivation.qbk deleted file mode 100644 index fe5b6dac..00000000 --- a/doc/10_motivation.qbk +++ /dev/null @@ -1,80 +0,0 @@ -[/ - Boost.Optional - - Copyright (c) 2003-2007 Fernando Luis Cacciola Carballal - Copyright (c) 2014 Andrzej Krzemienski - - Distributed under the Boost Software License, Version 1.0. - (See accompanying file LICENSE_1_0.txt or copy at - http://www.boost.org/LICENSE_1_0.txt) -] - -[section Motivation] - -Consider these functions which should return a value but which might not have -a value to return: - -* (A) `double sqrt(double n );` -* (B) `char get_async_input();` -* (C) `point polygon::get_any_point_effectively_inside();` - -There are different approaches to the issue of not having a value to return. - -A typical approach is to consider the existence of a valid return value as a -postcondition, so that if the function cannot compute the value to return, it -has either undefined behavior (and can use assert in a debug build) or uses a -runtime check and throws an exception if the postcondition is violated. This -is a reasonable choice for example, for function (A), because the lack of a -proper return value is directly related to an invalid parameter (out of domain -argument), so it is appropriate to require the callee to supply only parameters -in a valid domain for execution to continue normally. - -However, function (B), because of its asynchronous nature, does not fail just -because it can't find a value to return; so it is incorrect to consider such -a situation an error and assert or throw an exception. This function must -return, and somehow, must tell the callee that it is not returning a meaningful -value. - -A similar situation occurs with function (C): it is conceptually an error to -ask a ['null-area] polygon to return a point inside itself, but in many -applications, it is just impractical for performance reasons to treat this as -an error (because detecting that the polygon has no area might be too expensive -to be required to be tested previously), and either an arbitrary point -(typically at infinity) is returned, or some efficient way to tell the callee -that there is no such point is used. - -There are various mechanisms to let functions communicate that the returned -value is not valid. One such mechanism, which is quite common since it has -zero or negligible overhead, is to use a special value which is reserved to -communicate this. Classical examples of such special values are `EOF`, -`string::npos`, points at infinity, etc... - -When those values exist, i.e. the return type can hold all meaningful values -['plus] the ['signal] value, this mechanism is quite appropriate and well known. -Unfortunately, there are cases when such values do not exist. In these cases, -the usual alternative is either to use a wider type, such as `int` in place of -`char`; or a compound type, such as `std::pair`. - -Returning a `std::pair`, thus attaching a boolean flag to the result -which indicates if the result is meaningful, has the advantage that can be -turned into a consistent idiom since the first element of the pair can be -whatever the function would conceptually return. For example, the last two -functions could have the following interface: - - std::pair get_async_input(); - std::pair polygon::get_any_point_effectively_inside(); - -These functions use a consistent interface for dealing with possibly nonexistent -results: - - std::pair p = poly.get_any_point_effectively_inside(); - if ( p.second ) - flood_fill(p.first); - -However, not only is this quite a burden syntactically, it is also error prone -since the user can easily use the function result (first element of the pair) -without ever checking if it has a valid value. - -Clearly, we need a better idiom. - -[endsect] diff --git a/doc/11_development.qbk b/doc/11_development.qbk index de5d00d7..e5ef1ed3 100644 --- a/doc/11_development.qbk +++ b/doc/11_development.qbk @@ -2,250 +2,129 @@ Boost.Optional Copyright (c) 2003-2007 Fernando Luis Cacciola Carballal + Copyright (c) 2024 andrzej Krzemieński Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) ] -[section Design Overview] - -[section The models] - -In C++, we can ['declare] an object (a variable) of type `T`, and we can give this -variable an ['initial value] (through an ['initializer]. (cf. 8.5)). -When a declaration includes a non-empty initializer (an initial value is given), -it is said that the object has been initialized. -If the declaration uses an empty initializer (no initial value is given), and -neither default nor value initialization applies, it is said that the object is -[*uninitialized]. Its actual value exist but has an ['indeterminate initial value] -(cf. 8.5/11). -`optional` intends to formalize the notion of initialization (or lack of it) -allowing a program to test whether an object has been initialized and stating -that access to the value of an uninitialized object is undefined behavior. That -is, when a variable is declared as `optional` and no initial value is given, -the variable is ['formally] uninitialized. A formally uninitialized optional object -has conceptually no value at all and this situation can be tested at runtime. It -is formally ['undefined behavior] to try to access the value of an uninitialized -optional. An uninitialized optional can be assigned a value, in which case its initialization state changes to initialized. Furthermore, given the formal -treatment of initialization states in optional objects, it is even possible to -reset an optional to ['uninitialized]. - -In C++ there is no formal notion of uninitialized objects, which means that -objects always have an initial value even if indeterminate. -As discussed on the previous section, this has a drawback because you need -additional information to tell if an object has been effectively initialized. -One of the typical ways in which this has been historically dealt with is via -a special value: `EOF`, `npos`, -1, etc... This is equivalent to adding the -special value to the set of possible values of a given type. This super set of -`T` plus some ['nil_t]—where `nil_t` is some stateless POD—can be modeled in modern -languages as a [*discriminated union] of T and nil_t. Discriminated unions are -often called ['variants]. A variant has a ['current type], which in our case is either -`T` or `nil_t`. -Using the __BOOST_VARIANT__ library, this model can be implemented in terms of `boost::variant`. -There is precedent for a discriminated union as a model for an optional value: -the __HASKELL__ [*Maybe] built-in type constructor. Thus, a discriminated union -`T+nil_t` serves as a conceptual foundation. - -A `variant` follows naturally from the traditional idiom of extending -the range of possible values adding an additional sentinel value with the -special meaning of ['Nothing]. However, this additional ['Nothing] value is largely -irrelevant for our purpose since our goal is to formalize the notion of -uninitialized objects and, while a special extended value can be used to convey -that meaning, it is not strictly necessary in order to do so. - -The observation made in the last paragraph about the irrelevant nature of the -additional `nil_t` with respect to [_purpose] of `optional` suggests an -alternative model: a ['container] that either has a value of `T` or nothing. - -As of this writing I don't know of any precedent for a variable-size -fixed-capacity (of 1) stack-based container model for optional values, yet I -believe this is the consequence of the lack of practical implementations of -such a container rather than an inherent shortcoming of the container model. - -In any event, both the discriminated-union or the single-element container -models serve as a conceptual ground for a class representing optional—i.e. -possibly uninitialized—objects. -For instance, these models show the ['exact] semantics required for a wrapper -of optional values: - -Discriminated-union: - -* [*deep-copy] semantics: copies of the variant implies copies of the value. -* [*deep-relational] semantics: comparisons between variants matches both -current types and values -* If the variant's current type is `T`, it is modeling an ['initialized] optional. -* If the variant's current type is not `T`, it is modeling an ['uninitialized] -optional. -* Testing if the variant's current type is `T` models testing if the optional -is initialized -* Trying to extract a `T` from a variant when its current type is not `T`, models -the undefined behavior of trying to access the value of an uninitialized optional - -Single-element container: - -* [*deep-copy] semantics: copies of the container implies copies of the value. -* [*deep-relational] semantics: comparisons between containers compare container -size and if match, contained value -* If the container is not empty (contains an object of type `T`), it is modeling -an ['initialized] optional. -* If the container is empty, it is modeling an ['uninitialized] optional. -* Testing if the container is empty models testing if the optional is -initialized -* Trying to extract a `T` from an empty container models the undefined behavior -of trying to access the value of an uninitialized optional +[section Design Goals] + +In C++ you can create an automatic object of a scalar type, and manipulate it, +without assigning it the initial value. + + { + int i; // indeterminate value + populate(&i); + cout << i; + } + +Such an object is said to have ['indeterminate value]. If you subsequently +assign a proper value to the object, all is fine; but if the program tries to +read an indeterminate value, this is ['undefined behavior'], and since C++26 +this is ['erroneous behavior]. +In any case, the program is now likely to do something else than what the +programmer intended. In case you have some object `i`, and you do not know if it +has an indeterminate value, or a normal, intended, value, there is no way to +check it, because the checking would require reading the value. + +This is one of the primary problems that `optional` was intended to address: so +that you may have a type that knows whether it has been assigned a proper value, +and it can tell you that if requested. + +In the case of type `int` the internal representation of such a class could be: + + class OptionalInt + { + bool _has_value = false; + int _value; + }; + +In the general case, the internal representation is something equivalent to: + + template + class Optional + { + bool _has_value = false; + alignas(T) char _value [sizeof(T)]; + }; + +Next, because we need to pass around these "optional" `int`s as normal `int`s, +like returning them from functions, when copying, we need to copy `_has_value`, +which indicates whether we have the value or not, and, if we do have value, and +only then, to also copy `_value`. + +This means that our type requires ['deep copy] semantics. + +[note +This is a C++ equivalent of a +[@https://hackage.haskell.org/package/base-4.20.0.1/docs/Data-Maybe.html Maybe] +monad in [@http://www.haskell.org/ Haskell]. +] [endsect] -[section The semantics] - -Objects of type `optional` are intended to be used in places where objects of -type `T` would but which might be uninitialized. Hence, `optional`'s purpose is -to formalize the additional possibly uninitialized state. -From the perspective of this role, `optional` can have the same operational -semantics of `T` plus the additional semantics corresponding to this special -state. -As such, `optional` could be thought of as a ['supertype] of `T`. Of course, we -can't do that in C++, so we need to compose the desired semantics using a -different mechanism. -Doing it the other way around, that is, making `optional` a ['subtype] of `T` -is not only conceptually wrong but also impractical: it is not allowed to -derive from a non-class type, such as a built-in type. - -We can draw from the purpose of `optional` the required basic semantics: - -* [*Default Construction:] To introduce a formally uninitialized wrapped -object. -* [*Direct Value Construction via copy:] To introduce a formally initialized -wrapped object whose value is obtained as a copy of some object. -* [*Deep Copy Construction:] To obtain a new yet equivalent wrapped object. -* [*Direct Value Assignment (upon initialized):] To assign a value to the -wrapped object. -* [*Direct Value Assignment (upon uninitialized):] To initialize the wrapped -object with a value obtained as a copy of some object. -* [*Assignment (upon initialized):] To assign to the wrapped object the value -of another wrapped object. -* [*Assignment (upon uninitialized):] To initialize the wrapped object with -value of another wrapped object. -* [*Deep Relational Operations (when supported by the type T):] To compare -wrapped object values taking into account the presence of uninitialized states. -* [*Value access:] To unwrap the wrapped object. -* [*Initialization state query:] To determine if the object is formally -initialized or not. -* [*Swap:] To exchange wrapped objects. (with whatever exception safety -guarantees are provided by `T`'s swap). -* [*De-initialization:] To release the wrapped object (if any) and leave the -wrapper in the uninitialized state. - -Additional operations are useful, such as converting constructors and -converting assignments, in-place construction and assignment, and safe -value access via a pointer to the wrapped object or null. +[section:iface Interface Design] +One part of the interface is for modifying and setting the initial state of +the object. It has to be able to say that -[endsect] +* we want to store a specific value of type `T`, +* we want to store no value. + +The default constructor stores no value. Other than that, we require that +the assignment and construction from a `T` reflects the former, while assignment +and construction of a special ['tag] value `none` reflect the latter need. + + optional o1; // contains no value + optional o2 = 2; // contains value 2 + optional o3 = none; // contains no value + + o1 = 1; // assign value 1 + o2 = none; // assign a no-value + o3 = {}; // assign a no-value + +[heading Inspecting the State] + +Inspecting the state of an optional object requires two steps: -[section The Interface] - -Since the purpose of optional is to allow us to use objects with a formal -uninitialized additional state, the interface could try to follow the -interface of the underlying `T` type as much as possible. In order to choose -the proper degree of adoption of the native `T` interface, the following must -be noted: Even if all the operations supported by an instance of type `T` are -defined for the entire range of values for such a type, an `optional` -extends such a set of values with a new value for which most -(otherwise valid) operations are not defined in terms of `T`. - -Furthermore, since `optional` itself is merely a `T` wrapper (modeling a `T` -supertype), any attempt to define such operations upon uninitialized optionals -will be totally artificial w.r.t. `T`. - -This library chooses an interface which follows from `T`'s interface only for -those operations which are well defined (w.r.t the type `T`) even if any of the -operands are uninitialized. These operations include: construction, -copy-construction, assignment, swap and relational operations. - -For the value access operations, which are undefined (w.r.t the type `T`) when -the operand is uninitialized, a different interface is chosen (which will be -explained next). - -Also, the presence of the possibly uninitialized state requires additional -operations not provided by `T` itself which are supported by a special interface. - -[heading Lexically-hinted Value Access in the presence of possibly -uninitialized optional objects: The operators * and ->] - -A relevant feature of a pointer is that it can have a [*null pointer value]. -This is a ['special] value which is used to indicate that the pointer is not -referring to any object at all. In other words, null pointer values convey -the notion of nonexistent objects. - -This meaning of the null pointer value allowed pointers to became a ['de -facto] standard for handling optional objects because all you have to do -to refer to a value which you don't really have is to use a null pointer -value of the appropriate type. Pointers have been used for decades—from -the days of C APIs to modern C++ libraries—to ['refer] to optional (that is, -possibly nonexistent) objects; particularly as optional arguments to a -function, but also quite often as optional data members. - -The possible presence of a null pointer value makes the operations that -access the pointee's value possibly undefined, therefore, expressions which -use dereference and access operators, such as: `( *p = 2 )` and `( p->foo() )`, -implicitly convey the notion of optionality, and this information is tied to -the ['syntax] of the expressions. That is, the presence of operators `*` and `->` -tell by themselves —without any additional context— that the expression will -be undefined unless the implied pointee actually exist. - -Such a ['de facto] idiom for referring to optional objects can be formalized -in the form of a concept: the __OPTIONAL_POINTEE__ concept. -This concept captures the syntactic usage of operators `*`, `->` and -contextual conversion to `bool` to convey the notion of optionality. - -However, pointers are good to [_refer] to optional objects, but not particularly -good to handle the optional objects in all other respects, such as initializing -or moving/copying them. The problem resides in the shallow-copy of pointer -semantics: if you need to effectively move or copy the object, pointers alone -are not enough. The problem is that copies of pointers do not imply copies of -pointees. For example, as was discussed in the motivation, pointers alone -cannot be used to return optional objects from a function because the object -must move outside from the function and into the caller's context. - -A solution to the shallow-copy problem that is often used is to resort to -dynamic allocation and use a smart pointer to automatically handle the details -of this. For example, if a function is to optionally return an object `X`, it can -use `shared_ptr` as the return value. However, this requires dynamic allocation -of `X`. If `X` is a built-in or small POD, this technique is very poor in terms of -required resources. Optional objects are essentially values so it is very -convenient to be able to use automatic storage and deep-copy semantics to -manipulate optional values just as we do with ordinary values. Pointers do -not have this semantics, so are inappropriate for the initialization and -transport of optional values, yet are quite convenient for handling the access -to the possible undefined value because of the idiomatic aid present in the -__OPTIONAL_POINTEE__ concept incarnated by pointers. - - -[heading Optional as a model of OptionalPointee] - -For value access operations `optional<>` uses operators `*` and `->` to -lexically warn about the possibly uninitialized state appealing to the -familiar pointer semantics w.r.t. to null pointers. +* check if we have the value or not, +* if so, read the stored value. + +This 'procedure' is characteristic of inspecting pointers in C++, therefore the +pointer-like syntax was chosen to represent this. + + void inspect (optional os) + { + if (os) { // contextual conversion to `bool` + read_string(*os); // `operator*` to access the stored value + read_int(os->size()); // `operator->` as shortcut for accessing members + } + } + +Also, similarly to pointers, if you access the value when it is not there, +you trigger __UB__. +This library detects and reports it via +[@../../../assert/assert.html `BOOST_ASSERT()`]. This common property of +pointers and `optional<>` has been formalized into a concept __OPTIONAL_POINTEE__. + +However, there is also the counter-intuitive part. All pointers embed ['shallow-copy] +semantics: when you copy a pointer, the pointed-to object stays at the same location +and you can access it via either of the pointers. This is unlike optional objects +where the represented value is copied along. [caution -However, it is particularly important to note that `optional<>` objects -are not pointers. [_`optional<>` is not, and does not model, a pointer]. +Optional objects are not pointers. ] -For instance, `optional<>` does not have shallow-copy so does not alias: -two different optionals never refer to the ['same] value unless `T` itself is -a reference (but may have ['equivalent] values). -The difference between an `optional` and a pointer must be kept in mind, -particularly because the semantics of relational operators are different: -since `optional` is a value-wrapper, relational operators are deep: they -compare optional values; but relational operators for pointers are shallow: -they do not compare pointee values. -As a result, you might be able to replace `optional` by `T*` on some -situations but not always. Specifically, on generic code written for both, -you cannot use relational operators directly, and must use the template -functions __FUNCTION_EQUAL_POINTEES__ and __FUNCTION_LESS_POINTEES__ instead. +There is a similar difference in relational operations: they compare deeply for +`optional<>`, while they are shallow for pointers. -[endsect] +[note +When you need a deep relational operations that work uniformly for `optional<>` +and pointers in generic contexts, use functions +[@../../../utility/OptionalPointee.html#equal `equal_pointees()`] and +[@../../../utility/OptionalPointee.html#less `less_pointees()`]. +] [endsect] diff --git a/doc/13_relational_operators.qbk b/doc/12_relational_operators.qbk similarity index 100% rename from doc/13_relational_operators.qbk rename to doc/12_relational_operators.qbk diff --git a/doc/13_convenience.qbk b/doc/13_convenience.qbk new file mode 100644 index 00000000..9a95de3a --- /dev/null +++ b/doc/13_convenience.qbk @@ -0,0 +1,102 @@ + +[section Convenience Conversions and Deductions] + +Unlike `std::optional`, `boost::optional` does not offer a number of +"convenience" converting constructors, mixed relational operations and +deductions for class template parameters. + + std::optional oi = 1; // OK + + std:string_view sv = "hi"; + std::optional os = sv; // OK + os == sv; // OK + + std::optional osv; + std::optional os2 = osv; // OK + os2 == osv; // OK + +They are practical, ans sometimes stem from the argument for consistency: +if `(optT && *optT == u)` works then `(optT == u)` should also work. + +However, these intelligent convenience functions sometimes produce results +that are counter to the programmer intentions and produce silent bugs. + +Consider a more complicated example: + + Threshold th = /*...*/; + std::optional o = th; + assert (o); + +In this code, can we expect that thus initialized `optional` contains a value? +The answer is: it depends on the type of `Threshold`. It can be defined as: + + using Threshold = std::optional; + +And then the assertion will fire. This is because in this case the intelligence +decides that since we already have an optional, the additional wrapping into +a yet another optional is unnecessary. + +If we explicitly specify the template type, the situation doesn't get less +complicated. + + Threshold th; + std::optional o = th; + assert(o); + +Can this assertion fire? Now we have two competing constructors: + + template + optional(U const&); + + template + optional(optional const&); + +Which one will get chosen? Actually, we are lucky, and it is going to be the +first one due to concept tricks. But let's try a different example: + + Threshold th; + std::optional o = th; + assert(o); + assert(o == th); + +Here, the first assertion passes, but the second one fires. This is because +there are two competing overloads of the comparison operator: + + template + bool operator==(optional const&, U const&); + + template + bool operator==(optional const&, optional const&); + +And this time there is no concept trickery, so the second overload is chosen, +and gives different results: we are comparing an optional object `th`, which does +not contain a value, with an optional object `o` which does contain a value. + +This problem -- that the operations compile, but have runtime behavior counter +to programmer's intuition -- gains new significance with the introduction of +concepts to C++. + + static_assert(std::equality_comparable_with, Threshold>); + +Concepts have both syntactic constraints and semantic constraints. Syntactic +constraints are statically checked by the compiler. For semantic constraints, +functions that use the concept trust the programmer that these constraints are +met, and if not, this is __UB__. + +These are problems with `std::optional`. `boost::optional` doesn't have these +problems, because it does not offer the said convenience operations. + +The design principle for `boost::optional` is not to offer functionality that +nicely deduces the programmer intentions in 95% of the cases, and in the remaining +5% renders effects counter to programmer expectations. + +Instead, this library recommends using a more verbose syntax that works in 100% +of the cases: + + Threshold th; + auto o = boost::make_potional(th); // *always* add a new layer of optionality + + return boost::equal_pointees(o, th); // *always* unpack optionals for comparison + return o && *o == th; // *always* treat the right-hand side argument as value + +[endsect] diff --git a/doc/14_monadic_interface.qbk b/doc/14_monadic_interface.qbk deleted file mode 100644 index 21731e48..00000000 --- a/doc/14_monadic_interface.qbk +++ /dev/null @@ -1,45 +0,0 @@ -[section Monadic interface] - -The monadic interface of `optional` allows the application of functions -to optional values without resorting to the usage of explicit `if`-statements. - -Function `map` takes a function mapping type `T` onto type `U` and maps an `optional` -onto an `optional` using the provided function. - - int length(const string& s){ return s.size(); }; - - optional null{}, thin{""}, word{"word"}; - assert (null.map(length) == none); - assert (thin.map(length) == 0); - assert (word.map(length) == 4); - -Function `flat_map` is similar, but it requires the function to return an -`optional` for some type `V`. This `optional` becomes the return type of -`flat_map`. - - optional first_char(const string& s) { - if (s.empty()) return none; - else return s[0]; - }; - - optional null{}, thin{""}, word{"word"}; - assert (null.flat_map(first_char) == none); - assert (thin.flat_map(first_char) == none); - assert (word.flat_map(first_char) == 'w'); - -These functions can be combined in one expression reflecting a chain of computations: - - auto get_contents(path p) -> optional; - auto trim(string) -> string; - auto length(string) -> int; - - auto trimmed_size_of(optional p) -> int - { - return p.flat_map(get_contents) - .map(trim) - .map(length) - .value_or(0); - } - - -[endsect] diff --git a/doc/16_optional_references.qbk b/doc/16_optional_references.qbk index af663e1b..10664d72 100644 --- a/doc/16_optional_references.qbk +++ b/doc/16_optional_references.qbk @@ -23,7 +23,12 @@ will nonetheless refer to the same object. * Value-access will actually provide access to the referenced object rather than the reference itself. -[caution On compilers that do not conform to Standard C++ rules of reference binding, some operations on optional references are disabled in order to prevent subtle bugs. For more details see [link boost_optional.dependencies_and_portability.optional_reference_binding Dependencies and Portability section].] +[caution +On compilers that do not conform to Standard C++ rules of reference binding, +some operations on optional references are disabled in order to prevent subtle +bugs. For more details see +[link boost_optional.dependencies_and_portability.optional_reference_binding Dependencies and Portability section]. +] [heading Rvalue references] @@ -45,7 +50,7 @@ the first time) to the object. Clearly, there is no other choice. optional orb(x) ; ora = orb ; // now 'ora' is bound to 'x' through 'rx' *ora = 2 ; // Changes value of 'x' through 'ora' - assert(x==2); + assert(x==2); If you assign to a bare C++ reference, the assignment is forwarded to the referenced object; its value changes but the reference is never rebound. @@ -71,8 +76,8 @@ bare C++ references. optional orb(rb) ; ora = orb ; // 'ora' is rebound to 'b' *ora = 3 ; // Changes value of 'b' (not 'a') - assert(a==1); - assert(b==3); + assert(a==1); + assert(b==3); [heading Rationale] diff --git a/doc/1A_type_requirements.qbk b/doc/1A_type_requirements.qbk index 989cc4ab..214fcbff 100644 --- a/doc/1A_type_requirements.qbk +++ b/doc/1A_type_requirements.qbk @@ -7,8 +7,8 @@ The very minimum requirement of `optional` is that `T` is a complete type and assert(o == none); // check if initialized assert(!o); // o.value(); // always throws - -But this is practically useless. In order for `optional` to be able to do anything useful and offer all the spectrum of ways of accessing the contained value, `T` needs to have at least one accessible constructor. In that case you need to initialize the optional object with function `emplace()`, or if your compiler does not support it, resort to [link boost_optional.tutorial.in_place_factories In-Place Factories]: + +But this is practically useless. In order for `optional` to be able to do anything useful and offer all the spectrum of ways of accessing the contained value, `T` needs to have at least one accessible constructor. In that case you need to initialize the optional object with function `emplace()`, or if your compiler does not support it, resort to [link boost_optional.design.in_place_factories In-Place Factories]: optional o; o.emplace("T", "ctor", "params"); @@ -17,13 +17,13 @@ If `T` is __MOVE_CONSTRUCTIBLE__, `optional` is also __MOVE_CONSTRUCTIBLE__ a optional o = make_T(); optional p = optional(); - + If `T` is __COPY_CONSTRUCTIBLE__, `optional` is also __COPY_CONSTRUCTIBLE__ and can be easily initialized from an lvalue of type `T`: T v = make_T(); optional o = v; optional p = o; - + If `T` is not `MoveAssignable`, it is still possible to reset the value of `optional` using function `emplace()`: optional o = make_T(); diff --git a/doc/28_ref_optional_semantics.qbk b/doc/28_ref_optional_semantics.qbk index d3cb6eed..0fc90a73 100644 --- a/doc/28_ref_optional_semantics.qbk +++ b/doc/28_ref_optional_semantics.qbk @@ -281,7 +281,7 @@ factory. * [*Postconditions: ] `*this` is [_initialized] and its value is ['directly given] from the factory `f` (i.e., the value [_is not copied]). * [*Throws:] Whatever the `T` constructor called by the factory throws. -* [*Notes:] See [link boost_optional.tutorial.in_place_factories In-Place Factories] +* [*Notes:] See [link boost_optional.design.in_place_factories In-Place Factories] * [*Exception Safety:] Exceptions can only be thrown during the call to the `T` constructor used by the factory; in that case, this constructor has no effect. @@ -524,7 +524,7 @@ factory. * [*Postconditions: ] `*this` is [_initialized] and its value is ['directly given] from the factory `f` (i.e., the value [_is not copied]). * [*Throws:] Whatever the `T` constructor called by the factory throws. -* [*Notes:] See [link boost_optional.tutorial.in_place_factories In-Place Factories] +* [*Notes:] See [link boost_optional.design.in_place_factories In-Place Factories] * [*Exception Safety:] Exceptions can only be thrown during the call to the `T` constructor used by the factory; in that case, the `optional` object will be reset to be ['uninitialized]. @@ -963,7 +963,7 @@ __SPACE__ * [*Postconditions:] `bool(*this) == bool(rhs)`. -* [*Notes:] This behaviour is called ['rebinding semantics]. See [link boost_optional.tutorial.optional_references.rebinding_semantics_for_assignment_of_optional_references here] for details. +* [*Notes:] This behaviour is called ['rebinding semantics]. See [link boost_optional.design.optional_references.rebinding_semantics_for_assignment_of_optional_references here] for details. * [*Example:] `` diff --git a/doc/12_when_to_use.qbk b/doc/31_when_to_use.qbk similarity index 100% rename from doc/12_when_to_use.qbk rename to doc/31_when_to_use.qbk diff --git a/doc/1B_on_performance.qbk b/doc/32_on_performance.qbk similarity index 100% rename from doc/1B_on_performance.qbk rename to doc/32_on_performance.qbk diff --git a/doc/90_dependencies.qbk b/doc/90_dependencies.qbk index e0beee32..acc23c10 100644 --- a/doc/90_dependencies.qbk +++ b/doc/90_dependencies.qbk @@ -57,7 +57,7 @@ On compilers that do not support rvalue references, each of these functions is s template void emplace(Arg& arg); void emplace(); -This workaround addresses about 40% of all use cases. If this is insufficient, you need to resort to using [link boost_optional.tutorial.in_place_factories In-Place Factories]. +This workaround addresses about 40% of all use cases. If this is insufficient, you need to resort to using [link boost_optional.design.in_place_factories In-Place Factories]. [endsect] [section Optional Reference Binding][#optional_reference_binding] From dc7909db4a6cdfd7636ac593616b0b03b89c21e0 Mon Sep 17 00:00:00 2001 From: typenameTea Date: Wed, 18 Sep 2024 22:08:58 +0100 Subject: [PATCH 142/163] refactor: implementation tidy up C++11 is now the library minimum requirement, so clean up the interface by removing conditional compilation intended to support C++03 alongside C++11. --- .../optional_trivially_copyable_base.hpp | 242 +------- include/boost/optional/optional.hpp | 517 +----------------- 2 files changed, 2 insertions(+), 757 deletions(-) diff --git a/include/boost/optional/detail/optional_trivially_copyable_base.hpp b/include/boost/optional/detail/optional_trivially_copyable_base.hpp index 1d157cfe..a8e0371c 100644 --- a/include/boost/optional/detail/optional_trivially_copyable_base.hpp +++ b/include/boost/optional/detail/optional_trivially_copyable_base.hpp @@ -25,10 +25,8 @@ class tc_optional_base : public optional_tag protected: typedef T & reference_type ; typedef T const& reference_const_type ; -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES typedef T && rval_reference_type ; typedef T && reference_type_of_temporary_wrapper ; -#endif typedef T * pointer_type ; typedef T const* pointer_const_type ; typedef T const& argument_type ; @@ -51,9 +49,6 @@ class tc_optional_base : public optional_tag // tc_optional_base ( tc_optional_base const& ) = default; - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - template explicit tc_optional_base ( Expr&& expr, PtrExpr const* tag ) : @@ -62,20 +57,6 @@ class tc_optional_base : public optional_tag construct(boost::forward(expr),tag); } -#else - // This is used for both converting and in-place constructions. - // Derived classes use the 'tag' to select the appropriate - // implementation (the correct 'construct()' overload) - template - explicit tc_optional_base ( Expr const& expr, Expr const* tag ) - : - m_initialized(false) - { - construct(expr,tag); - } - -#endif - // tc_optional_base& operator= ( tc_optional_base const& ) = default; // ~tc_optional_base() = default; @@ -99,7 +80,6 @@ class tc_optional_base : public optional_tag m_initialized = rhs.is_initialized(); } -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // move-assigns from another _convertible_ optional (deep-moves from the rhs value) template void assign ( optional&& rhs ) @@ -109,7 +89,6 @@ class tc_optional_base : public optional_tag m_storage = static_cast(rhs.get()); m_initialized = rhs.is_initialized(); } -#endif void assign ( argument_type val ) { @@ -120,19 +99,11 @@ class tc_optional_base : public optional_tag #ifndef BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES template void assign_expr ( Expr&& expr, ExprPtr const* tag ) { construct(boost::forward(expr),tag); } -#else - template - void assign_expr ( Expr const& expr, Expr const* tag ) - { - construct(expr,tag); - } -#endif #endif @@ -162,7 +133,6 @@ class tc_optional_base : public optional_tag } -#if (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) && (!defined BOOST_NO_CXX11_VARIADIC_TEMPLATES) // Constructs in-place // upon exception *this is always uninitialized template @@ -194,146 +164,9 @@ class tc_optional_base : public optional_tag if ( cond ) construct(in_place_init, boost::forward(args)...); } -#elif (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) - template - void construct ( in_place_init_t, Arg&& arg ) - { - m_storage = value_type( boost::forward(arg) ); - m_initialized = true ; - } - - void construct ( in_place_init_t ) - { - m_storage = value_type(); - m_initialized = true ; - } - - template - void emplace_assign ( Arg&& arg ) - { - construct(in_place_init, boost::forward(arg)) ; - } - - void emplace_assign () - { - construct(in_place_init) ; - } - - template - explicit tc_optional_base ( in_place_init_t, Arg&& arg ) - : - m_initialized(false) - { - construct(in_place_init, boost::forward(arg)); - } - - explicit tc_optional_base ( in_place_init_t ) - : - m_initialized(false), m_storage() {} - - template - explicit tc_optional_base ( in_place_init_if_t, bool cond, Arg&& arg ) - : - m_initialized(false) - { - if ( cond ) - construct(in_place_init, boost::forward(arg)); - } - - explicit tc_optional_base ( in_place_init_if_t, bool cond ) - : - m_initialized(false) - { - if ( cond ) - construct(in_place_init); - } - -#else - - template - void construct ( in_place_init_t, const Arg& arg ) - { - m_storage = value_type( arg ); - m_initialized = true ; - } - - template - void construct ( in_place_init_t, Arg& arg ) - { - m_storage = value_type( arg ); - m_initialized = true ; - } - - void construct ( in_place_init_t ) - { - m_storage = value_type(); - m_initialized = true ; - } - - template - void emplace_assign ( const Arg& arg ) - { - construct(in_place_init, arg); - } - - template - void emplace_assign ( Arg& arg ) - { - construct(in_place_init, arg); - } - - void emplace_assign () - { - construct(in_place_init); - } - - template - explicit tc_optional_base ( in_place_init_t, const Arg& arg ) - : m_initialized(false) - { - construct(in_place_init, arg); - } - - template - explicit tc_optional_base ( in_place_init_t, Arg& arg ) - : m_initialized(false) - { - construct(in_place_init, arg); - } - - explicit tc_optional_base ( in_place_init_t ) - : m_initialized(false) - { - construct(in_place_init); - } - - template - explicit tc_optional_base ( in_place_init_if_t, bool cond, const Arg& arg ) - : m_initialized(false) - { - if ( cond ) - construct(in_place_init, arg); - } - - template - explicit tc_optional_base ( in_place_init_if_t, bool cond, Arg& arg ) - : m_initialized(false) - { - if ( cond ) - construct(in_place_init, arg); - } - - explicit tc_optional_base ( in_place_init_if_t, bool cond ) - : m_initialized(false) - { - if ( cond ) - construct(in_place_init); - } -#endif #ifndef BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Constructs in-place using the given factory template void construct ( Expr&& factory, in_place_factory_base const* ) @@ -365,42 +198,8 @@ class tc_optional_base : public optional_tag construct(factory,tag); } -#else - // Constructs in-place using the given factory - template - void construct ( Expr const& factory, in_place_factory_base const* ) - { - boost_optional_detail::construct(factory, boost::addressof(m_storage)); - m_initialized = true ; - } - - // Constructs in-place using the given typed factory - template - void construct ( Expr const& factory, typed_in_place_factory_base const* ) - { - factory.apply(boost::addressof(m_storage)) ; - m_initialized = true ; - } - - template - void assign_expr_to_initialized ( Expr const& factory, in_place_factory_base const* tag ) - { - destroy(); - construct(factory,tag); - } - - // Constructs in-place using the given typed factory - template - void assign_expr_to_initialized ( Expr const& factory, typed_in_place_factory_base const* tag ) - { - destroy(); - construct(factory,tag); - } -#endif - #endif -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Constructs using any expression implicitly convertible to the single argument // of a one-argument T constructor. // Converting constructions of optional from optional uses this function with @@ -421,29 +220,6 @@ class tc_optional_base : public optional_tag { assign_value( boost::forward(expr) ); } -#else - // Constructs using any expression implicitly convertible to the single argument - // of a one-argument T constructor. - // Converting constructions of optional from optional uses this function with - // 'Expr' being of type 'U' and relying on a converting constructor of T from U. - template - void construct ( Expr const& expr, void const* ) - { - m_storage = value_type(expr) ; - m_initialized = true ; - } - - // Assigns using a form any expression implicitly convertible to the single argument - // of a T's assignment operator. - // Converting assignments of optional from optional uses this function with - // 'Expr' being of type 'U' and relying on a converting assignment of T from U. - template - void assign_expr_to_initialized ( Expr const& expr, void const* ) - { - assign_value(expr); - } - -#endif #ifdef BOOST_OPTIONAL_WEAK_OVERLOAD_RESOLUTION // BCB5.64 (and probably lower versions) workaround. @@ -458,7 +234,7 @@ class tc_optional_base : public optional_tag // For VC<=70 compilers this workaround doesn't work because the compiler issues and error // instead of choosing the wrong overload // -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES + // Notice that 'Expr' will be optional or optional (but not tc_optional_base<..>) template void construct ( Expr&& expr, optional_tag const* ) @@ -471,26 +247,10 @@ class tc_optional_base : public optional_tag m_initialized = true ; } } -#else - // Notice that 'Expr' will be optional or optional (but not tc_optional_base<..>) - template - void construct ( Expr const& expr, optional_tag const* ) - { - if ( expr.is_initialized() ) - { - // An exception can be thrown here. - // It it happens, THIS will be left uninitialized. - m_storage = value_type(expr.get()) ; - m_initialized = true ; - } - } -#endif #endif // defined BOOST_OPTIONAL_WEAK_OVERLOAD_RESOLUTION void assign_value ( argument_type val ) { m_storage = val; } -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES void assign_value ( rval_reference_type val ) { m_storage = static_cast(val); } -#endif void destroy() { diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index df3c8a38..b755d911 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -145,10 +145,8 @@ class optional_base : public optional_tag protected: typedef T & reference_type ; typedef T const& reference_const_type ; -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES typedef T && rval_reference_type ; typedef T && reference_type_of_temporary_wrapper ; -#endif typedef T * pointer_type ; typedef T const* pointer_const_type ; typedef T const& argument_type ; @@ -174,7 +172,6 @@ class optional_base : public optional_tag construct(val); } -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // move-construct an optional initialized from an rvalue-ref to 'val'. // Can throw if T::T(T&&) does optional_base ( init_value_tag, rval_reference_type val ) @@ -183,7 +180,6 @@ class optional_base : public optional_tag { construct( boost::move(val) ); } -#endif // Creates an optional initialized with 'val' IFF cond is true, otherwise creates an uninitialized optional. // Can throw if T::T(T const&) does @@ -195,7 +191,6 @@ class optional_base : public optional_tag construct(val); } -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Creates an optional initialized with 'move(val)' IFF cond is true, otherwise creates an uninitialized optional. // Can throw if T::T(T &&) does optional_base ( bool cond, rval_reference_type val ) @@ -205,7 +200,6 @@ class optional_base : public optional_tag if ( cond ) construct(boost::move(val)); } -#endif // Creates a deep copy of another optional // Can throw if T::T(T const&) does @@ -217,7 +211,6 @@ class optional_base : public optional_tag construct(rhs.get_impl()); } -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Creates a deep move of another optional // Can throw if T::T(T&&) does optional_base ( optional_base&& rhs ) @@ -228,9 +221,7 @@ class optional_base : public optional_tag if ( rhs.is_initialized() ) construct( boost::move(rhs.get_impl()) ); } -#endif -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES template explicit optional_base ( Expr&& expr, PtrExpr const* tag ) @@ -240,34 +231,18 @@ class optional_base : public optional_tag construct(boost::forward(expr),tag); } -#else - // This is used for both converting and in-place constructions. - // Derived classes use the 'tag' to select the appropriate - // implementation (the correct 'construct()' overload) - template - explicit optional_base ( Expr const& expr, Expr const* tag ) - : - m_initialized(false) - { - construct(expr,tag); - } - -#endif - optional_base& operator= ( optional_base const& rhs ) { this->assign(rhs); return *this; } -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES optional_base& operator= ( optional_base && rhs ) BOOST_NOEXCEPT_IF(::boost::is_nothrow_move_constructible::value && ::boost::is_nothrow_move_assignable::value) { this->assign(static_cast(rhs)); return *this; } -#endif // No-throw (assuming T::~T() doesn't) ~optional_base() { destroy() ; } @@ -288,7 +263,6 @@ class optional_base : public optional_tag } } -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Assigns from another optional (deep-moves the rhs value) void assign ( optional_base&& rhs ) { @@ -304,7 +278,6 @@ class optional_base : public optional_tag construct(boost::move(rhs.get_impl())); } } -#endif // Assigns from another _convertible_ optional (deep-copies the rhs value) template @@ -332,7 +305,6 @@ class optional_base : public optional_tag } } -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // move-assigns from another _convertible_ optional (deep-moves from the rhs value) template void assign ( optional&& rhs ) @@ -350,7 +322,6 @@ class optional_base : public optional_tag construct(static_cast(rhs.get())); } } -#endif // Assigns from a T (deep-copies the rhs value) void assign ( argument_type val ) @@ -360,7 +331,6 @@ class optional_base : public optional_tag else construct(val); } -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Assigns from a T (deep-moves the rhs value) void assign ( rval_reference_type val ) { @@ -368,7 +338,6 @@ class optional_base : public optional_tag assign_value( boost::move(val) ); else construct( boost::move(val) ); } -#endif // Assigns from "none", destroying the current value, if any, leaving this UNINITIALIZED // No-throw (assuming T::~T() doesn't) @@ -376,7 +345,6 @@ class optional_base : public optional_tag #ifndef BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES template void assign_expr ( Expr&& expr, ExprPtr const* tag ) { @@ -384,15 +352,6 @@ class optional_base : public optional_tag assign_expr_to_initialized(boost::forward(expr),tag); else construct(boost::forward(expr),tag); } -#else - template - void assign_expr ( Expr const& expr, Expr const* tag ) - { - if (is_initialized()) - assign_expr_to_initialized(expr,tag); - else construct(expr,tag); - } -#endif #endif @@ -421,16 +380,13 @@ class optional_base : public optional_tag m_initialized = true ; } -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES void construct ( rval_reference_type val ) { ::new (m_storage.address()) unqualified_value_type( boost::move(val) ) ; m_initialized = true ; } -#endif -#if (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) && (!defined BOOST_NO_CXX11_VARIADIC_TEMPLATES) // Constructs in-place // upon exception *this is always uninitialized template @@ -463,154 +419,9 @@ class optional_base : public optional_tag if ( cond ) construct(in_place_init, boost::forward(args)...); } -#elif (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) - template - void construct ( in_place_init_t, Arg&& arg ) - { - ::new (m_storage.address()) unqualified_value_type( boost::forward(arg) ); - m_initialized = true ; - } - - void construct ( in_place_init_t ) - { - ::new (m_storage.address()) unqualified_value_type(); - m_initialized = true ; - } - - template - void emplace_assign ( Arg&& arg ) - { - destroy(); - construct(in_place_init, boost::forward(arg)) ; - } - - void emplace_assign () - { - destroy(); - construct(in_place_init) ; - } - - template - explicit optional_base ( in_place_init_t, Arg&& arg ) - : - m_initialized(false) - { - construct(in_place_init, boost::forward(arg)); - } - - explicit optional_base ( in_place_init_t ) - : - m_initialized(false) - { - construct(in_place_init); - } - - template - explicit optional_base ( in_place_init_if_t, bool cond, Arg&& arg ) - : - m_initialized(false) - { - if ( cond ) - construct(in_place_init, boost::forward(arg)); - } - - explicit optional_base ( in_place_init_if_t, bool cond ) - : - m_initialized(false) - { - if ( cond ) - construct(in_place_init); - } - -#else - - template - void construct ( in_place_init_t, const Arg& arg ) - { - ::new (m_storage.address()) unqualified_value_type( arg ); - m_initialized = true ; - } - - template - void construct ( in_place_init_t, Arg& arg ) - { - ::new (m_storage.address()) unqualified_value_type( arg ); - m_initialized = true ; - } - - void construct ( in_place_init_t ) - { - ::new (m_storage.address()) unqualified_value_type(); - m_initialized = true ; - } - - template - void emplace_assign ( const Arg& arg ) - { - destroy(); - construct(in_place_init, arg); - } - - template - void emplace_assign ( Arg& arg ) - { - destroy(); - construct(in_place_init, arg); - } - - void emplace_assign () - { - destroy(); - construct(in_place_init); - } - - template - explicit optional_base ( in_place_init_t, const Arg& arg ) - : m_initialized(false) - { - construct(in_place_init, arg); - } - - template - explicit optional_base ( in_place_init_t, Arg& arg ) - : m_initialized(false) - { - construct(in_place_init, arg); - } - - explicit optional_base ( in_place_init_t ) - : m_initialized(false) - { - construct(in_place_init); - } - - template - explicit optional_base ( in_place_init_if_t, bool cond, const Arg& arg ) - : m_initialized(false) - { - if ( cond ) - construct(in_place_init, arg); - } - - template - explicit optional_base ( in_place_init_if_t, bool cond, Arg& arg ) - : m_initialized(false) - { - if ( cond ) - construct(in_place_init, arg); - } - - explicit optional_base ( in_place_init_if_t, bool cond ) - : m_initialized(false) - { - if ( cond ) - construct(in_place_init); - } -#endif #ifndef BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Constructs in-place using the given factory template void construct ( Expr&& factory, in_place_factory_base const* ) @@ -642,42 +453,8 @@ class optional_base : public optional_tag construct(factory,tag); } -#else - // Constructs in-place using the given factory - template - void construct ( Expr const& factory, in_place_factory_base const* ) - { - boost_optional_detail::construct(factory, m_storage.address()); - m_initialized = true ; - } - - // Constructs in-place using the given typed factory - template - void construct ( Expr const& factory, typed_in_place_factory_base const* ) - { - factory.apply(m_storage.address()) ; - m_initialized = true ; - } - - template - void assign_expr_to_initialized ( Expr const& factory, in_place_factory_base const* tag ) - { - destroy(); - construct(factory,tag); - } - - // Constructs in-place using the given typed factory - template - void assign_expr_to_initialized ( Expr const& factory, typed_in_place_factory_base const* tag ) - { - destroy(); - construct(factory,tag); - } -#endif - #endif -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Constructs using any expression implicitly convertible to the single argument // of a one-argument T constructor. // Converting constructions of optional from optional uses this function with @@ -698,29 +475,6 @@ class optional_base : public optional_tag { assign_value( boost::forward(expr) ); } -#else - // Constructs using any expression implicitly convertible to the single argument - // of a one-argument T constructor. - // Converting constructions of optional from optional uses this function with - // 'Expr' being of type 'U' and relying on a converting constructor of T from U. - template - void construct ( Expr const& expr, void const* ) - { - new (m_storage.address()) unqualified_value_type(expr) ; - m_initialized = true ; - } - - // Assigns using a form any expression implicitly convertible to the single argument - // of a T's assignment operator. - // Converting assignments of optional from optional uses this function with - // 'Expr' being of type 'U' and relying on a converting assignment of T from U. - template - void assign_expr_to_initialized ( Expr const& expr, void const* ) - { - assign_value(expr); - } - -#endif #ifdef BOOST_OPTIONAL_WEAK_OVERLOAD_RESOLUTION // BCB5.64 (and probably lower versions) workaround. @@ -735,7 +489,7 @@ class optional_base : public optional_tag // For VC<=70 compilers this workaround doesn't work because the compiler issues and error // instead of choosing the wrong overload // -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES + // Notice that 'Expr' will be optional or optional (but not optional_base<..>) template void construct ( Expr&& expr, optional_tag const* ) @@ -748,26 +502,10 @@ class optional_base : public optional_tag m_initialized = true ; } } -#else - // Notice that 'Expr' will be optional or optional (but not optional_base<..>) - template - void construct ( Expr const& expr, optional_tag const* ) - { - if ( expr.is_initialized() ) - { - // An exception can be thrown here. - // It it happens, THIS will be left uninitialized. - new (m_storage.address()) unqualified_value_type(expr.get()) ; - m_initialized = true ; - } - } -#endif #endif // defined BOOST_OPTIONAL_WEAK_OVERLOAD_RESOLUTION void assign_value ( argument_type val ) { get_impl() = val; } -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES void assign_value ( rval_reference_type val ) { get_impl() = static_cast(val); } -#endif void destroy() { @@ -928,10 +666,8 @@ class optional typedef BOOST_DEDUCED_TYPENAME base::value_type value_type ; typedef BOOST_DEDUCED_TYPENAME base::reference_type reference_type ; typedef BOOST_DEDUCED_TYPENAME base::reference_const_type reference_const_type ; -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES typedef BOOST_DEDUCED_TYPENAME base::rval_reference_type rval_reference_type ; typedef BOOST_DEDUCED_TYPENAME base::reference_type_of_temporary_wrapper reference_type_of_temporary_wrapper ; -#endif typedef BOOST_DEDUCED_TYPENAME base::pointer_type pointer_type ; typedef BOOST_DEDUCED_TYPENAME base::pointer_const_type pointer_const_type ; typedef BOOST_DEDUCED_TYPENAME base::argument_type argument_type ; @@ -948,23 +684,19 @@ class optional // Can throw if T::T(T const&) does optional ( argument_type val ) : base(optional_detail::init_value_tag(), val) {} -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Creates an optional initialized with 'move(val)'. // Can throw if T::T(T &&) does optional ( rval_reference_type val ) : base(optional_detail::init_value_tag(), boost::forward(val)) {} -#endif // Creates an optional initialized with 'val' IFF cond is true, otherwise creates an uninitialized optional. // Can throw if T::T(T const&) does optional ( bool cond, argument_type val ) : base(cond,val) {} -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES /// Creates an optional initialized with 'val' IFF cond is true, otherwise creates an uninitialized optional. // Can throw if T::T(T &&) does optional ( bool cond, rval_reference_type val ) : base( cond, boost::forward(val) ) {} -#endif // NOTE: MSVC needs templated versions first @@ -984,7 +716,6 @@ class optional this->construct(rhs.get()); } -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Creates a deep move of another convertible optional // Requires a valid conversion from U to T. // Can throw if T::T(U&&) does @@ -1000,7 +731,6 @@ class optional if ( rhs.is_initialized() ) this->construct( boost::move(rhs.get()) ); } -#endif #ifndef BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT // Creates an optional with an expression which can be either @@ -1012,7 +742,6 @@ class optional // even though explicit overloads are present for these. // Depending on the above some T ctor is called. // Can throw if the resolved T ctor throws. -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES template @@ -1022,10 +751,6 @@ class optional : base(boost::forward(expr),boost::addressof(expr)) {} -#else - template - explicit optional ( Expr const& expr ) : base(expr,boost::addressof(expr)) {} -#endif // !defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES #endif // !defined BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT // Creates a deep copy of another optional @@ -1036,10 +761,8 @@ class optional optional ( optional const& rhs ) : base( static_cast(rhs) ) {} #endif -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Creates a deep move of another optional // Can throw if T::T(T&&) does - #ifndef BOOST_OPTIONAL_DETAIL_NO_DEFAULTED_MOVE_FUNCTIONS optional ( optional && ) = default; #else @@ -1049,7 +772,6 @@ class optional {} #endif -#endif #if BOOST_WORKAROUND(_MSC_VER, <= 1600) // On old MSVC compilers the implicitly declared dtor is not called @@ -1060,7 +782,6 @@ class optional #if !defined(BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT) && !defined(BOOST_OPTIONAL_WEAK_OVERLOAD_RESOLUTION) // Assigns from an expression. See corresponding constructor. // Basic Guarantee: If the resolved T ctor throws, this is left UNINITIALIZED -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES template BOOST_DEDUCED_TYPENAME boost::enable_if, optional&>::type @@ -1070,14 +791,6 @@ class optional return *this ; } -#else - template - optional& operator= ( Expr const& expr ) - { - this->assign_expr(expr,boost::addressof(expr)); - return *this ; - } -#endif // !defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES #endif // !defined(BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT) && !defined(BOOST_OPTIONAL_WEAK_OVERLOAD_RESOLUTION) // Copy-assigns from another convertible optional (converts && deep-copies the rhs value) @@ -1090,7 +803,6 @@ class optional return *this ; } -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Move-assigns from another convertible optional (converts && deep-moves the rhs value) // Requires a valid conversion from U to T. // Basic Guarantee: If T::T( U && ) throws, this is left UNINITIALIZED @@ -1100,7 +812,6 @@ class optional this->assign(boost::move(rhs)); return *this ; } -#endif // Assigns from another optional (deep-copies the rhs value) // Basic Guarantee: If T::T( T const& ) throws, this is left UNINITIALIZED @@ -1115,7 +826,6 @@ class optional } #endif -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Assigns from another optional (deep-moves the rhs value) #ifndef BOOST_OPTIONAL_DETAIL_NO_DEFAULTED_MOVE_FUNCTIONS optional& operator= ( optional && ) = default; @@ -1128,9 +838,7 @@ class optional } #endif -#endif // BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES -#ifndef BOOST_NO_CXX11_UNIFIED_INITIALIZATION_SYNTAX // Assigns from a T (deep-moves/copies the rhs value) template @@ -1141,26 +849,6 @@ class optional return *this ; } -#else - - // Assigns from a T (deep-copies the rhs value) - // Basic Guarantee: If T::( T const& ) throws, this is left UNINITIALIZED - optional& operator= ( argument_type val ) - { - this->assign( val ) ; - return *this ; - } - -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - // Assigns from a T (deep-moves the rhs value) - optional& operator= ( rval_reference_type val ) - { - this->assign( boost::move(val) ) ; - return *this ; - } -#endif - -#endif // BOOST_NO_CXX11_UNIFIED_INITIALIZATION_SYNTAX // Assigns from a "none" // Which destroys the current value, if any, leaving this UNINITIALIZED @@ -1171,7 +859,6 @@ class optional return *this ; } -#if (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) && (!defined BOOST_NO_CXX11_VARIADIC_TEMPLATES) // Constructs in-place // upon exception *this is always uninitialized template @@ -1190,82 +877,6 @@ class optional : base( in_place_init_if, cond, boost::forward(args)... ) {} -#elif (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) - template - void emplace ( Arg&& arg ) - { - this->emplace_assign( boost::forward(arg) ); - } - - void emplace () - { - this->emplace_assign(); - } - - template - explicit optional ( in_place_init_t, Args&& args ) - : base( in_place_init, boost::forward(args) ) - {} - - explicit optional ( in_place_init_t ) - : base( in_place_init ) - {} - - template - explicit optional ( in_place_init_if_t, bool cond, Args&& args ) - : base( in_place_init_if, cond, boost::forward(args) ) - {} - - explicit optional ( in_place_init_if_t, bool cond ) - : base( in_place_init_if, cond ) - {} -#else - template - void emplace ( const Arg& arg ) - { - this->emplace_assign( arg ); - } - - template - void emplace ( Arg& arg ) - { - this->emplace_assign( arg ); - } - - void emplace () - { - this->emplace_assign(); - } - - template - explicit optional ( in_place_init_t, const Arg& arg ) - : base( in_place_init, arg ) - {} - - template - explicit optional ( in_place_init_t, Arg& arg ) - : base( in_place_init, arg ) - {} - - explicit optional ( in_place_init_t ) - : base( in_place_init ) - {} - - template - explicit optional ( in_place_init_if_t, bool cond, const Arg& arg ) - : base( in_place_init_if, cond, arg ) - {} - - template - explicit optional ( in_place_init_if_t, bool cond, Arg& arg ) - : base( in_place_init_if, cond, arg ) - {} - - explicit optional ( in_place_init_if_t, bool cond ) - : base( in_place_init_if, cond ) - {} -#endif - void swap( optional & arg ) BOOST_NOEXCEPT_IF(::boost::is_nothrow_move_constructible::value && ::boost::is_nothrow_move_assignable::value) { @@ -1293,16 +904,10 @@ class optional // Returns a reference to the value if this is initialized, otherwise, // the behaviour is UNDEFINED // No-throw -#if (!defined BOOST_NO_CXX11_REF_QUALIFIERS) && (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) reference_const_type operator *() const& { return this->get() ; } reference_type operator *() & { return this->get() ; } reference_type_of_temporary_wrapper operator *() && { return boost::move(this->get()) ; } -#else - reference_const_type operator *() const { return this->get() ; } - reference_type operator *() { return this->get() ; } -#endif // !defined BOOST_NO_CXX11_REF_QUALIFIERS -#if (!defined BOOST_NO_CXX11_REF_QUALIFIERS) && (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) reference_const_type value() const& { if (this->is_initialized()) @@ -1327,26 +932,8 @@ class optional throw_exception(bad_optional_access()); } -#else - reference_const_type value() const - { - if (this->is_initialized()) - return this->get() ; - else - throw_exception(bad_optional_access()); - } - - reference_type value() - { - if (this->is_initialized()) - return this->get() ; - else - throw_exception(bad_optional_access()); - } -#endif -#ifndef BOOST_NO_CXX11_REF_QUALIFIERS template value_type value_or ( U&& v ) const& { @@ -1364,36 +951,7 @@ class optional else return boost::forward(v); } -#elif !defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - template - value_type value_or ( U&& v ) const - { - if (this->is_initialized()) - return get(); - else - return boost::forward(v); - } -#else - template - value_type value_or ( U const& v ) const - { - if (this->is_initialized()) - return get(); - else - return v; - } - template - value_type value_or ( U& v ) const - { - if (this->is_initialized()) - return get(); - else - return v; - } -#endif - -#if (!defined BOOST_NO_CXX11_REF_QUALIFIERS) && (!defined BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES) template value_type value_or_eval ( F f ) const& { @@ -1469,57 +1027,6 @@ class optional return none; } -#else - template - value_type value_or_eval ( F f ) const - { - if (this->is_initialized()) - return get(); - else - return f(); - } - - template - optional::type> - map(F f) - { - if (this->has_value()) - return f(get()); - else - return none; - } - - template - optional::type> - map(F f) const - { - if (this->has_value()) - return f(get()); - else - return none; - } - - template - optional::type> - flat_map(F f) - { - if (this->has_value()) - return f(get()); - else - return none; - } - - template - optional::type> - flat_map(F f) const - { - if (this->has_value()) - return f(get()); - else - return none; - } - -#endif bool has_value() const BOOST_NOEXCEPT { return this->is_initialized() ; } @@ -1527,13 +1034,11 @@ class optional } ; -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES template class optional { BOOST_STATIC_ASSERT_MSG(sizeof(T) == 0, "Optional rvalue references are illegal."); } ; -#endif } // namespace boost @@ -1543,7 +1048,6 @@ class optional namespace boost { -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES template inline @@ -1560,25 +1064,6 @@ optional::type> make_optional ( bool cond return optional::type>(cond,boost::forward(v)); } -#else - -// Returns optional(v) -template -inline -optional make_optional ( T const& v ) -{ - return optional(v); -} - -// Returns optional(cond,v) -template -inline -optional make_optional ( bool cond, T const& v ) -{ - return optional(cond,v); -} - -#endif // BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES // Returns a reference to the value if this is initialized, otherwise, the behaviour is UNDEFINED. // No-throw From ae15fc54b2d9ff2c4845d6ee688e2100038cfc24 Mon Sep 17 00:00:00 2001 From: typenameTea Date: Thu, 19 Sep 2024 22:14:24 +0100 Subject: [PATCH 143/163] refactor: add back unified init syntax conditional --- include/boost/optional/optional.hpp | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index b755d911..37b5c359 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -838,7 +838,7 @@ class optional } #endif - +#ifndef BOOST_NO_CXX11_UNIFIED_INITIALIZATION_SYNTAX // Assigns from a T (deep-moves/copies the rhs value) template @@ -849,6 +849,24 @@ class optional return *this ; } +#else + + // Assigns from a T (deep-copies the rhs value) + // Basic Guarantee: If T::( T const& ) throws, this is left UNINITIALIZED + optional& operator= ( argument_type val ) + { + this->assign( val ) ; + return *this ; + } + + // Assigns from a T (deep-moves the rhs value) + optional& operator= ( rval_reference_type val ) + { + this->assign( boost::move(val) ) ; + return *this ; + } + +#endif // BOOST_NO_CXX11_UNIFIED_INITIALIZATION_SYNTAX // Assigns from a "none" // Which destroys the current value, if any, leaving this UNINITIALIZED From 1820ae55ef915ba82bff9103c67646ba1168b3e6 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Fri, 27 Sep 2024 16:10:56 +0200 Subject: [PATCH 144/163] docs no longer mention perfect forwarding workarounds --- doc/13_convenience.qbk | 2 +- doc/28_ref_optional_semantics.qbk | 6 +++--- doc/90_dependencies.qbk | 35 ------------------------------- 3 files changed, 4 insertions(+), 39 deletions(-) diff --git a/doc/13_convenience.qbk b/doc/13_convenience.qbk index 9a95de3a..0989b5a7 100644 --- a/doc/13_convenience.qbk +++ b/doc/13_convenience.qbk @@ -15,7 +15,7 @@ deductions for class template parameters. std::optional os2 = osv; // OK os2 == osv; // OK -They are practical, ans sometimes stem from the argument for consistency: +They are practical, and sometimes stem from the argument for consistency: if `(optT && *optT == u)` works then `(optT == u)` should also work. However, these intelligent convenience functions sometimes produce results diff --git a/doc/28_ref_optional_semantics.qbk b/doc/28_ref_optional_semantics.qbk index 0fc90a73..9a5986f9 100644 --- a/doc/28_ref_optional_semantics.qbk +++ b/doc/28_ref_optional_semantics.qbk @@ -233,7 +233,7 @@ __SPACE__ arguments `std::forward(args)...`. * [*Postconditions:] `*this` is initialized. * [*Throws:] Any exception thrown by the selected constructor of `T`. -* [*Notes: ] `T` need not be __MOVE_CONSTRUCTIBLE__. On compilers that do not support variadic templates or rvalue references, this constuctor is available in limited functionality. For details [link optional_emplace_workaround see here]. +* [*Notes: ] `T` need not be __MOVE_CONSTRUCTIBLE__. * [*Example:] `` @@ -257,7 +257,7 @@ __SPACE__ * [*Effect:] If `condition` is `true`, initializes the contained value as if direct-non-list-initializing an object of type `T` with the arguments `std::forward(args)...`. * [*Postconditions:] `bool(*this) == condition`. * [*Throws:] Any exception thrown by the selected constructor of `T`. -* [*Notes: ] `T` need not be __MOVE_CONSTRUCTIBLE__. On compilers that do not support variadic templates or rvalue references, this constuctor is available in limited functionality. For details [link optional_emplace_workaround see here]. +* [*Notes: ] `T` need not be __MOVE_CONSTRUCTIBLE__. * [*Example:] `` @@ -502,7 +502,7 @@ __SPACE__ * [*Postconditions: ] `*this` is [_initialized]. * [*Throws:] Whatever the selected `T`'s constructor throws. * [*Exception Safety:] If an exception is thrown during the initialization of `T`, `*this` is ['uninitialized]. -* [*Notes:] `T` need not be __MOVE_CONSTRUCTIBLE__ or `MoveAssignable`. On compilers that do not support variadic templates or rvalue references, this function is available in limited functionality. For details [link optional_emplace_workaround see here]. +* [*Notes:] `T` need not be __MOVE_CONSTRUCTIBLE__ or `MoveAssignable`. * [*Example:] `` T v; diff --git a/doc/90_dependencies.qbk b/doc/90_dependencies.qbk index acc23c10..365f2be3 100644 --- a/doc/90_dependencies.qbk +++ b/doc/90_dependencies.qbk @@ -24,41 +24,6 @@ The implementation uses the following other Boost modules: [endsect] -[section Emplace operations in older compilers][#optional_emplace_workaround] - -Certain constructors and functions in the interface of `optional` perform a 'perfect forwarding' of arguments: - - template optional(in_place_init_t, Args&&... args); - template optional(in_place_init_if_t, bool condition, Args&&... args); - template void emplace(Args&&... args); - -On compilers that do not support variadic templates, each of these functions is substituted with two overloads, one forwarding a single argument, the other forwarding zero arguments. This forms the following set: - - template optional(in_place_init_t, Arg&& arg); - optional(in_place_init_t); - - template optional(in_place_init_if_t, bool condition, Arg&& arg); - optional(in_place_init_if_t, bool condition); - - template void emplace(Arg&& arg); - void emplace(); - -On compilers that do not support rvalue references, each of these functions is substituted with three overloads: taking `const` and non-`const` lvalue reference, and third forwarding zero arguments. This forms the following set: - - template optional(in_place_init_t, const Arg& arg); - template optional(in_place_init_t, Arg& arg); - optional(in_place_init_t); - - template optional(in_place_init_if_t, bool condition, const Arg& arg); - template optional(in_place_init_if_t, bool condition, Arg& arg); - optional(in_place_init_if_t, bool condition); - - template void emplace(const Arg& arg); - template void emplace(Arg& arg); - void emplace(); - -This workaround addresses about 40% of all use cases. If this is insufficient, you need to resort to using [link boost_optional.design.in_place_factories In-Place Factories]. -[endsect] [section Optional Reference Binding][#optional_reference_binding] From cacde054df5e5547c5c38d6f62299dd2ae50e25f Mon Sep 17 00:00:00 2001 From: typenameTea Date: Sat, 28 Sep 2024 17:18:00 +0100 Subject: [PATCH 145/163] refactor: drop Boost.Move dependency Implement constexpr definitions of forward and move to replace usage of boost::move and boost::forward from the Boost.Move library. Alter tests to use std::move instead of boost::move. Remove the dependency on Boost.Move from build.jam --- CMakeLists.txt | 1 - build.jam | 1 - doc/90_dependencies.qbk | 1 - .../detail/optional_reference_spec.hpp | 2 +- .../boost/optional/detail/optional_swap.hpp | 2 +- .../optional_trivially_copyable_base.hpp | 18 ++-- .../optional/detail/optional_utility.hpp | 38 +++++++++ include/boost/optional/optional.hpp | 82 +++++++++---------- include/boost/optional/optional_io.hpp | 2 +- test/optional_test_flat_map.cpp | 4 +- test/optional_test_map.cpp | 6 +- test/optional_test_move.cpp | 26 +++--- test/optional_test_noexcept_move.cpp | 8 +- 13 files changed, 113 insertions(+), 78 deletions(-) create mode 100644 include/boost/optional/detail/optional_utility.hpp diff --git a/CMakeLists.txt b/CMakeLists.txt index 976738b5..75ea3364 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -17,7 +17,6 @@ target_link_libraries(boost_optional Boost::assert Boost::config Boost::core - Boost::move Boost::static_assert Boost::throw_exception Boost::type_traits diff --git a/build.jam b/build.jam index 5c8089b5..6f1fcf6d 100644 --- a/build.jam +++ b/build.jam @@ -9,7 +9,6 @@ constant boost_dependencies : /boost/assert//boost_assert /boost/config//boost_config /boost/core//boost_core - /boost/move//boost_move /boost/static_assert//boost_static_assert /boost/throw_exception//boost_throw_exception /boost/type_traits//boost_type_traits ; diff --git a/doc/90_dependencies.qbk b/doc/90_dependencies.qbk index 365f2be3..8f849a19 100644 --- a/doc/90_dependencies.qbk +++ b/doc/90_dependencies.qbk @@ -17,7 +17,6 @@ The implementation uses the following other Boost modules: # assert # config # core -# move # static_assert # throw_exception # type_traits diff --git a/include/boost/optional/detail/optional_reference_spec.hpp b/include/boost/optional/detail/optional_reference_spec.hpp index 9cb2b5c1..30824c26 100644 --- a/include/boost/optional/detail/optional_reference_spec.hpp +++ b/include/boost/optional/detail/optional_reference_spec.hpp @@ -39,7 +39,7 @@ BOOST_DEDUCED_TYPENAME boost::remove_reference::type& forward_reference(T&& r { BOOST_STATIC_ASSERT_MSG(boost::is_lvalue_reference::value, "binding rvalue references to optional lvalue references is disallowed"); - return boost::forward(r); + return optional_detail::forward(r); } #endif // BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES diff --git a/include/boost/optional/detail/optional_swap.hpp b/include/boost/optional/detail/optional_swap.hpp index f4eceabb..0c708c6c 100644 --- a/include/boost/optional/detail/optional_swap.hpp +++ b/include/boost/optional/detail/optional_swap.hpp @@ -54,7 +54,7 @@ struct swap_selector #endif #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES -# define BOOST_OPTIONAL_DETAIL_MOVE(EXPR_) boost::move(EXPR_) +# define BOOST_OPTIONAL_DETAIL_MOVE(EXPR_) optional_detail::move(EXPR_) #else # define BOOST_OPTIONAL_DETAIL_MOVE(EXPR_) EXPR_ #endif diff --git a/include/boost/optional/detail/optional_trivially_copyable_base.hpp b/include/boost/optional/detail/optional_trivially_copyable_base.hpp index a8e0371c..3a08f7d8 100644 --- a/include/boost/optional/detail/optional_trivially_copyable_base.hpp +++ b/include/boost/optional/detail/optional_trivially_copyable_base.hpp @@ -54,7 +54,7 @@ class tc_optional_base : public optional_tag : m_initialized(false) { - construct(boost::forward(expr),tag); + construct(optional_detail::forward(expr),tag); } // tc_optional_base& operator= ( tc_optional_base const& ) = default; @@ -102,7 +102,7 @@ class tc_optional_base : public optional_tag template void assign_expr ( Expr&& expr, ExprPtr const* tag ) { - construct(boost::forward(expr),tag); + construct(optional_detail::forward(expr),tag); } #endif @@ -138,14 +138,14 @@ class tc_optional_base : public optional_tag template void construct ( in_place_init_t, Args&&... args ) { - m_storage = value_type( boost::forward(args)... ) ; + m_storage = value_type( optional_detail::forward(args)... ) ; m_initialized = true ; } template void emplace_assign ( Args&&... args ) { - construct(in_place_init, boost::forward(args)...); + construct(in_place_init, optional_detail::forward(args)...); } template @@ -153,7 +153,7 @@ class tc_optional_base : public optional_tag : m_initialized(false) { - construct(in_place_init, boost::forward(args)...); + construct(in_place_init, optional_detail::forward(args)...); } template @@ -162,7 +162,7 @@ class tc_optional_base : public optional_tag m_initialized(false) { if ( cond ) - construct(in_place_init, boost::forward(args)...); + construct(in_place_init, optional_detail::forward(args)...); } #ifndef BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT @@ -207,7 +207,7 @@ class tc_optional_base : public optional_tag template void construct ( Expr&& expr, void const* ) { - m_storage = value_type(boost::forward(expr)) ; + m_storage = value_type(optional_detail::forward(expr)) ; m_initialized = true ; } @@ -218,7 +218,7 @@ class tc_optional_base : public optional_tag template void assign_expr_to_initialized ( Expr&& expr, void const* ) { - assign_value( boost::forward(expr) ); + assign_value( optional_detail::forward(expr) ); } #ifdef BOOST_OPTIONAL_WEAK_OVERLOAD_RESOLUTION @@ -243,7 +243,7 @@ class tc_optional_base : public optional_tag { // An exception can be thrown here. // It it happens, THIS will be left uninitialized. - m_storage = value_type(boost::move(expr.get())) ; + m_storage = value_type(optional_detail::move(expr.get())) ; m_initialized = true ; } } diff --git a/include/boost/optional/detail/optional_utility.hpp b/include/boost/optional/detail/optional_utility.hpp new file mode 100644 index 00000000..6fd2fd2a --- /dev/null +++ b/include/boost/optional/detail/optional_utility.hpp @@ -0,0 +1,38 @@ +// Copyright (C) 2024 Andrzej Krzemienski. +// +// Use, modification, and distribution is subject to the Boost Software +// License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at +// http://www.boost.org/LICENSE_1_0.txt) +// +// See http://www.boost.org/libs/optional for documentation. +// +// You are welcome to contact the author at: +// akrzemi1@gmail.com + +#ifndef BOOST_OPTIONAL_OPTIONAL_DETAIL_OPTIONAL_UTILITY_HPP +#define BOOST_OPTIONAL_OPTIONAL_DETAIL_OPTIONAL_UTILITY_HPP + +namespace boost { +namespace optional_detail { + +// Workaround: forward and move aren't constexpr in C++11 +template inline constexpr T&& forward(typename boost::remove_reference::type& t) noexcept +{ + return static_cast(t); +} + +template inline constexpr T&& forward(typename boost::remove_reference::type&& t) noexcept +{ + BOOST_STATIC_ASSERT_MSG(!boost::is_lvalue_reference::value, "Can not forward an rvalue as an lvalue."); + return static_cast(t); +} + +template inline constexpr typename boost::remove_reference::type&& move(T&& t) noexcept +{ + return static_cast::type&&>(t); +} + +} // namespace optional_detail +} // namespace boost + +#endif diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 37b5c359..6aec3cec 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -51,7 +51,6 @@ #include #include #include -#include #include #include @@ -59,6 +58,7 @@ #include #include #include +#include namespace boost { namespace optional_detail { @@ -178,7 +178,7 @@ class optional_base : public optional_tag : m_initialized(false) { - construct( boost::move(val) ); + construct( optional_detail::move(val) ); } // Creates an optional initialized with 'val' IFF cond is true, otherwise creates an uninitialized optional. @@ -198,7 +198,7 @@ class optional_base : public optional_tag m_initialized(false) { if ( cond ) - construct(boost::move(val)); + construct(optional_detail::move(val)); } // Creates a deep copy of another optional @@ -219,7 +219,7 @@ class optional_base : public optional_tag m_initialized(false) { if ( rhs.is_initialized() ) - construct( boost::move(rhs.get_impl()) ); + construct( optional_detail::move(rhs.get_impl()) ); } @@ -228,7 +228,7 @@ class optional_base : public optional_tag : m_initialized(false) { - construct(boost::forward(expr),tag); + construct(optional_detail::forward(expr),tag); } optional_base& operator= ( optional_base const& rhs ) @@ -269,13 +269,13 @@ class optional_base : public optional_tag if (is_initialized()) { if ( rhs.is_initialized() ) - assign_value( boost::move(rhs.get_impl()) ); + assign_value( optional_detail::move(rhs.get_impl()) ); else destroy(); } else { if ( rhs.is_initialized() ) - construct(boost::move(rhs.get_impl())); + construct(optional_detail::move(rhs.get_impl())); } } @@ -335,8 +335,8 @@ class optional_base : public optional_tag void assign ( rval_reference_type val ) { if (is_initialized()) - assign_value( boost::move(val) ); - else construct( boost::move(val) ); + assign_value( optional_detail::move(val) ); + else construct( optional_detail::move(val) ); } // Assigns from "none", destroying the current value, if any, leaving this UNINITIALIZED @@ -349,8 +349,8 @@ class optional_base : public optional_tag void assign_expr ( Expr&& expr, ExprPtr const* tag ) { if (is_initialized()) - assign_expr_to_initialized(boost::forward(expr),tag); - else construct(boost::forward(expr),tag); + assign_expr_to_initialized(optional_detail::forward(expr),tag); + else construct(optional_detail::forward(expr),tag); } #endif @@ -382,7 +382,7 @@ class optional_base : public optional_tag void construct ( rval_reference_type val ) { - ::new (m_storage.address()) unqualified_value_type( boost::move(val) ) ; + ::new (m_storage.address()) unqualified_value_type( optional_detail::move(val) ) ; m_initialized = true ; } @@ -392,7 +392,7 @@ class optional_base : public optional_tag template void construct ( in_place_init_t, Args&&... args ) { - ::new (m_storage.address()) unqualified_value_type( boost::forward(args)... ) ; + ::new (m_storage.address()) unqualified_value_type( optional_detail::forward(args)... ) ; m_initialized = true ; } @@ -400,7 +400,7 @@ class optional_base : public optional_tag void emplace_assign ( Args&&... args ) { destroy(); - construct(in_place_init, boost::forward(args)...); + construct(in_place_init, optional_detail::forward(args)...); } template @@ -408,7 +408,7 @@ class optional_base : public optional_tag : m_initialized(false) { - construct(in_place_init, boost::forward(args)...); + construct(in_place_init, optional_detail::forward(args)...); } template @@ -417,7 +417,7 @@ class optional_base : public optional_tag m_initialized(false) { if ( cond ) - construct(in_place_init, boost::forward(args)...); + construct(in_place_init, optional_detail::forward(args)...); } #ifndef BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT @@ -462,7 +462,7 @@ class optional_base : public optional_tag template void construct ( Expr&& expr, void const* ) { - new (m_storage.address()) unqualified_value_type(boost::forward(expr)) ; + new (m_storage.address()) unqualified_value_type(optional_detail::forward(expr)) ; m_initialized = true ; } @@ -473,7 +473,7 @@ class optional_base : public optional_tag template void assign_expr_to_initialized ( Expr&& expr, void const* ) { - assign_value( boost::forward(expr) ); + assign_value( optional_detail::forward(expr) ); } #ifdef BOOST_OPTIONAL_WEAK_OVERLOAD_RESOLUTION @@ -498,7 +498,7 @@ class optional_base : public optional_tag { // An exception can be thrown here. // It it happens, THIS will be left uninitialized. - new (m_storage.address()) unqualified_value_type(boost::move(expr.get())) ; + new (m_storage.address()) unqualified_value_type(optional_detail::move(expr.get())) ; m_initialized = true ; } } @@ -686,7 +686,7 @@ class optional // Creates an optional initialized with 'move(val)'. // Can throw if T::T(T &&) does - optional ( rval_reference_type val ) : base(optional_detail::init_value_tag(), boost::forward(val)) + optional ( rval_reference_type val ) : base(optional_detail::init_value_tag(), optional_detail::forward(val)) {} // Creates an optional initialized with 'val' IFF cond is true, otherwise creates an uninitialized optional. @@ -695,7 +695,7 @@ class optional /// Creates an optional initialized with 'val' IFF cond is true, otherwise creates an uninitialized optional. // Can throw if T::T(T &&) does - optional ( bool cond, rval_reference_type val ) : base( cond, boost::forward(val) ) + optional ( bool cond, rval_reference_type val ) : base( cond, optional_detail::forward(val) ) {} // NOTE: MSVC needs templated versions first @@ -729,7 +729,7 @@ class optional base() { if ( rhs.is_initialized() ) - this->construct( boost::move(rhs.get()) ); + this->construct( optional_detail::move(rhs.get()) ); } #ifndef BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT @@ -748,7 +748,7 @@ class optional explicit optional ( Expr&& expr, BOOST_DEDUCED_TYPENAME boost::enable_if< optional_detail::is_optional_val_init_candidate, bool>::type = true ) - : base(boost::forward(expr),boost::addressof(expr)) + : base(optional_detail::forward(expr),boost::addressof(expr)) {} #endif // !defined BOOST_OPTIONAL_NO_INPLACE_FACTORY_SUPPORT @@ -768,7 +768,7 @@ class optional #else optional ( optional && rhs ) BOOST_NOEXCEPT_IF(::boost::is_nothrow_move_constructible::value) - : base( boost::move(rhs) ) + : base( optional_detail::move(rhs) ) {} #endif @@ -787,7 +787,7 @@ class optional BOOST_DEDUCED_TYPENAME boost::enable_if, optional&>::type operator= ( Expr&& expr ) { - this->assign_expr(boost::forward(expr),boost::addressof(expr)); + this->assign_expr(optional_detail::forward(expr),boost::addressof(expr)); return *this ; } @@ -809,7 +809,7 @@ class optional template optional& operator= ( optional && rhs ) { - this->assign(boost::move(rhs)); + this->assign(optional_detail::move(rhs)); return *this ; } @@ -845,7 +845,7 @@ class optional BOOST_DEDUCED_TYPENAME boost::enable_if::type>, optional&>::type operator= ( T_&& val ) { - this->assign( boost::forward(val) ) ; + this->assign( optional_detail::forward(val) ) ; return *this ; } @@ -862,7 +862,7 @@ class optional // Assigns from a T (deep-moves the rhs value) optional& operator= ( rval_reference_type val ) { - this->assign( boost::move(val) ) ; + this->assign( optional_detail::move(val) ) ; return *this ; } @@ -882,17 +882,17 @@ class optional template void emplace ( Args&&... args ) { - this->emplace_assign( boost::forward(args)... ); + this->emplace_assign( optional_detail::forward(args)... ); } template explicit optional ( in_place_init_t, Args&&... args ) - : base( in_place_init, boost::forward(args)... ) + : base( in_place_init, optional_detail::forward(args)... ) {} template explicit optional ( in_place_init_if_t, bool cond, Args&&... args ) - : base( in_place_init_if, cond, boost::forward(args)... ) + : base( in_place_init_if, cond, optional_detail::forward(args)... ) {} void swap( optional & arg ) @@ -924,7 +924,7 @@ class optional // No-throw reference_const_type operator *() const& { return this->get() ; } reference_type operator *() & { return this->get() ; } - reference_type_of_temporary_wrapper operator *() && { return boost::move(this->get()) ; } + reference_type_of_temporary_wrapper operator *() && { return optional_detail::move(this->get()) ; } reference_const_type value() const& { @@ -945,7 +945,7 @@ class optional reference_type_of_temporary_wrapper value() && { if (this->is_initialized()) - return boost::move(this->get()) ; + return optional_detail::move(this->get()) ; else throw_exception(bad_optional_access()); } @@ -958,16 +958,16 @@ class optional if (this->is_initialized()) return get(); else - return boost::forward(v); + return optional_detail::forward(v); } template value_type value_or ( U&& v ) && { if (this->is_initialized()) - return boost::move(get()); + return optional_detail::move(get()); else - return boost::forward(v); + return optional_detail::forward(v); } template @@ -983,7 +983,7 @@ class optional value_type value_or_eval ( F f ) && { if (this->is_initialized()) - return boost::move(get()); + return optional_detail::move(get()); else return f(); } @@ -1010,7 +1010,7 @@ class optional optional::type> map(F f) && { if (this->has_value()) - return f(boost::move(this->get())); + return f(optional_detail::move(this->get())); else return none; } @@ -1040,7 +1040,7 @@ class optional flat_map(F f) && { if (this->has_value()) - return f(boost::move(get())); + return f(optional_detail::move(get())); else return none; } @@ -1071,7 +1071,7 @@ template inline optional::type> make_optional ( T && v ) { - return optional::type>(boost::forward(v)); + return optional::type>(optional_detail::forward(v)); } // Returns optional(cond,v) @@ -1079,7 +1079,7 @@ template inline optional::type> make_optional ( bool cond, T && v ) { - return optional::type>(cond,boost::forward(v)); + return optional::type>(cond,optional_detail::forward(v)); } diff --git a/include/boost/optional/optional_io.hpp b/include/boost/optional/optional_io.hpp index 3db6ddae..b9ffc254 100644 --- a/include/boost/optional/optional_io.hpp +++ b/include/boost/optional/optional_io.hpp @@ -64,7 +64,7 @@ operator>>(std::basic_istream& in, optional& v) T x; in >> x; #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - v = boost::move(x); + v = std::move(x); #else v = x; #endif diff --git a/test/optional_test_flat_map.cpp b/test/optional_test_flat_map.cpp index 05ed63aa..14311b5b 100644 --- a/test/optional_test_flat_map.cpp +++ b/test/optional_test_flat_map.cpp @@ -240,8 +240,8 @@ void test_flat_map_move_only() { { optional om (makeMoveOnly(1)), om2 (makeMoveOnly(2)); - verify_type >(boost::move(om).flat_map(get_val)); - optional oi = boost::move(om2).flat_map(get_val); + verify_type >(std::move(om).flat_map(get_val)); + optional oi = std::move(om2).flat_map(get_val); BOOST_TEST(bool(oi)); BOOST_TEST_EQ(2, *oi); } diff --git a/test/optional_test_map.cpp b/test/optional_test_map.cpp index f0b7f0e2..61a1824d 100644 --- a/test/optional_test_map.cpp +++ b/test/optional_test_map.cpp @@ -62,8 +62,8 @@ int get_val(MoveOnly m) void test_map_move_only() { optional om (makeMoveOnly(7)), om2 (makeMoveOnly(8)); - verify_type >(boost::move(om).map(get_val)); - optional oi = boost::move(om2).map(get_val); + verify_type >(std::move(om).map(get_val)); + optional oi = std::move(om2).map(get_val); BOOST_TEST(bool(oi)); BOOST_TEST_EQ(8, *oi); @@ -72,7 +72,7 @@ void test_map_move_only() BOOST_TEST_EQ(4, *oj); optional o_; - optional oi_ = boost::move(o_).map(get_val); + optional oi_ = std::move(o_).map(get_val); BOOST_TEST(!oi_); } diff --git a/test/optional_test_move.cpp b/test/optional_test_move.cpp index f27cd998..5561d92e 100644 --- a/test/optional_test_move.cpp +++ b/test/optional_test_move.cpp @@ -82,7 +82,7 @@ void test_move_ctor_from_U() BOOST_TEST(o2->s == sValueCopyConstructed || o2->s == sCopyConstructed || o2->s == sMoveConstructed ); BOOST_TEST(v1.s == sIntConstructed); - optional o3 (boost::move(v1)); + optional o3 (std::move(v1)); BOOST_TEST(o3); BOOST_TEST(o3->s == sValueMoveConstructed || o3->s == sMoveConstructed); BOOST_TEST(v1.s == sMovedFrom); @@ -100,7 +100,7 @@ void test_move_ctor_form_T() BOOST_TEST(o2->s == sCopyConstructed); BOOST_TEST(v1.s == sDefaultConstructed); - optional o3 (boost::move(v1)); + optional o3 (std::move(v1)); BOOST_TEST(o3); BOOST_TEST(o3->s == sMoveConstructed); BOOST_TEST(v1.s == sMovedFrom); @@ -109,13 +109,13 @@ void test_move_ctor_form_T() void test_move_ctor_from_optional_T() { optional o1; - optional o2(boost::move(o1)); + optional o2(std::move(o1)); BOOST_TEST(!o1); BOOST_TEST(!o2); optional o3((Oracle())); - optional o4(boost::move(o3)); + optional o4(std::move(o3)); BOOST_TEST(o3); BOOST_TEST(o4); BOOST_TEST(o3->s == sMovedFrom); @@ -156,7 +156,7 @@ void test_move_assign_from_U() BOOST_TEST(v1.s == sIntConstructed); optional o3; - o3 = boost::move(v1); + o3 = std::move(v1); BOOST_TEST(o3); BOOST_TEST(o3->s == sValueMoveConstructed); BOOST_TEST(v1.s == sMovedFrom); @@ -185,7 +185,7 @@ void test_move_assign_from_T() BOOST_TEST(v1.s == sDefaultConstructed); optional o3; - o3 = boost::move(v1); + o3 = std::move(v1); BOOST_TEST(o3); BOOST_TEST(o3->s == sMoveConstructed); BOOST_TEST(v1.s == sMovedFrom); @@ -204,7 +204,7 @@ void test_move_assign_from_optional_T() BOOST_TEST(o1); BOOST_TEST(o1->s == sCopyConstructed); - o2 = boost::move(o3); + o2 = std::move(o3); BOOST_TEST(o3); BOOST_TEST(o3->s == sMovedFrom); BOOST_TEST(o2); @@ -236,15 +236,15 @@ void test_with_move_only() optional o2((MoveOnly(1))); BOOST_TEST(o2); BOOST_TEST(o2->val == 1); - optional o3 (boost::move(o1)); + optional o3 (std::move(o1)); BOOST_TEST(!o3); - optional o4 (boost::move(o2)); + optional o4 (std::move(o2)); BOOST_TEST(o4); BOOST_TEST(o4->val == 1); BOOST_TEST(o2); BOOST_TEST(o2->val == 0); - o3 = boost::move(o4); + o3 = std::move(o4); BOOST_TEST(o3); BOOST_TEST(o3->val == 1); BOOST_TEST(o4); @@ -272,7 +272,7 @@ void test_move_assign_from_optional_U() { optional a((MoveOnly(2))); optional b1; - b1 = boost::move(a); + b1 = std::move(a); BOOST_TEST(b1); BOOST_TEST(b1->val == 2); @@ -288,7 +288,7 @@ void test_move_assign_from_optional_U() void test_move_ctor_from_optional_U() { optional a((MoveOnly(2))); - optional b1(boost::move(a)); + optional b1(std::move(a)); BOOST_TEST(b1); BOOST_TEST(b1->val == 2); @@ -323,7 +323,7 @@ void test_optional_ref_to_movables() BOOST_TEST(m.val == 1); BOOST_TEST(orm->val == 1); - optional orm3 = boost::move(orm); + optional orm3 = std::move(orm); orm3->val = 4; BOOST_TEST(m.val == 4); BOOST_TEST(orm->val == 4); diff --git a/test/optional_test_noexcept_move.cpp b/test/optional_test_noexcept_move.cpp index 258bacd2..bc4fa97a 100644 --- a/test/optional_test_noexcept_move.cpp +++ b/test/optional_test_noexcept_move.cpp @@ -89,19 +89,19 @@ void test_noexcept_optional_with_operator() // compile-time test ONx0 onx0; BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( ONx2() )); - BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( ONx2(boost::move(onx2)) )); + BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( ONx2(std::move(onx2)) )); BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( onx2 = ONx2() )); BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( ONxC() )); - BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( ONxC(boost::move(onxC)) )); + BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( ONxC(std::move(onxC)) )); BOOST_STATIC_ASSERT(!BOOST_NOEXCEPT_EXPR( onxC = ONxC() )); BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( ONxA() )); - BOOST_STATIC_ASSERT(!BOOST_NOEXCEPT_EXPR( ONxA(boost::move(onxA)) )); + BOOST_STATIC_ASSERT(!BOOST_NOEXCEPT_EXPR( ONxA(std::move(onxA)) )); BOOST_STATIC_ASSERT(!BOOST_NOEXCEPT_EXPR( onxA = ONxA() )); BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( ONx0() )); - BOOST_STATIC_ASSERT(!BOOST_NOEXCEPT_EXPR( ONx0(boost::move(onx0)) )); + BOOST_STATIC_ASSERT(!BOOST_NOEXCEPT_EXPR( ONx0(std::move(onx0)) )); BOOST_STATIC_ASSERT(!BOOST_NOEXCEPT_EXPR( onx0 = ONx0() )); } From 825f38f5b5a7ec83e96906f12bc31f8b9b14ea47 Mon Sep 17 00:00:00 2001 From: Alexander Grund Date: Fri, 4 Oct 2024 20:07:11 +0200 Subject: [PATCH 146/163] CML: Create header-only target in IDEs Since CMake 3.19 it is possible to specify private sources for `INTERFACE` targets. This makes the library turn up like compiled libraries in IDEs such as Visual Studio. It can also be specified in the `add_library` call but using `target_sources` is more isolated to the CMake version check --- CMakeLists.txt | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/CMakeLists.txt b/CMakeLists.txt index 976738b5..79540d43 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -11,6 +11,10 @@ add_library(boost_optional INTERFACE) add_library(Boost::optional ALIAS boost_optional) target_include_directories(boost_optional INTERFACE include) +if(NOT CMAKE_VERSION VERSION_LESS "3.19") + file(GLOB_RECURSE headers include/*.hpp) + target_sources(boost_optional PRIVATE ${headers}) +endif() target_link_libraries(boost_optional INTERFACE From cfcd23d55b0dc4e9e3a88c0a3db9fdd4224b2ccc Mon Sep 17 00:00:00 2001 From: typenametea Date: Fri, 4 Oct 2024 21:02:26 +0100 Subject: [PATCH 147/163] docs: Update release notes --- doc/92_relnotes.qbk | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/92_relnotes.qbk b/doc/92_relnotes.qbk index ed16e736..649cad78 100644 --- a/doc/92_relnotes.qbk +++ b/doc/92_relnotes.qbk @@ -16,6 +16,7 @@ * *Breaking change.* Dropped support for C++03. C++11 is now the required minimum. * Dropped dependency on Boost.Utility. * Dropped dependency on Boost.Predef. +* Dropped dependency on Boost.Move. * A bit faster implementation of some relational operations. * Tags `in_place_init` and `in_place_init_if` become `inline constexpr` and therewith leave smaller footprint in the executable. This addresses [@https://github.com/boostorg/optional/issues/103 issue #103]. From c33708c1f99bfda566c00ed4d0894a8535701b5c Mon Sep 17 00:00:00 2001 From: typenameTea Date: Sat, 5 Oct 2024 12:47:10 +0100 Subject: [PATCH 148/163] refactor: address code review comments --- include/boost/optional/detail/optional_utility.hpp | 13 ++++++++----- include/boost/optional/optional_io.hpp | 6 +----- 2 files changed, 9 insertions(+), 10 deletions(-) diff --git a/include/boost/optional/detail/optional_utility.hpp b/include/boost/optional/detail/optional_utility.hpp index 6fd2fd2a..a5ef508b 100644 --- a/include/boost/optional/detail/optional_utility.hpp +++ b/include/boost/optional/detail/optional_utility.hpp @@ -1,4 +1,4 @@ -// Copyright (C) 2024 Andrzej Krzemienski. +// Copyright (C) 2024 typenameTea. // // Use, modification, and distribution is subject to the Boost Software // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at @@ -7,7 +7,7 @@ // See http://www.boost.org/libs/optional for documentation. // // You are welcome to contact the author at: -// akrzemi1@gmail.com +// typenametea@gmail.com #ifndef BOOST_OPTIONAL_OPTIONAL_DETAIL_OPTIONAL_UTILITY_HPP #define BOOST_OPTIONAL_OPTIONAL_DETAIL_OPTIONAL_UTILITY_HPP @@ -16,18 +16,21 @@ namespace boost { namespace optional_detail { // Workaround: forward and move aren't constexpr in C++11 -template inline constexpr T&& forward(typename boost::remove_reference::type& t) noexcept +template +inline constexpr T&& forward(typename boost::remove_reference::type& t) noexcept { return static_cast(t); } -template inline constexpr T&& forward(typename boost::remove_reference::type&& t) noexcept +template +inline constexpr T&& forward(typename boost::remove_reference::type&& t) noexcept { BOOST_STATIC_ASSERT_MSG(!boost::is_lvalue_reference::value, "Can not forward an rvalue as an lvalue."); return static_cast(t); } -template inline constexpr typename boost::remove_reference::type&& move(T&& t) noexcept +template +inline constexpr typename boost::remove_reference::type&& move(T&& t) noexcept { return static_cast::type&&>(t); } diff --git a/include/boost/optional/optional_io.hpp b/include/boost/optional/optional_io.hpp index b9ffc254..85acfa17 100644 --- a/include/boost/optional/optional_io.hpp +++ b/include/boost/optional/optional_io.hpp @@ -63,11 +63,7 @@ operator>>(std::basic_istream& in, optional& v) { T x; in >> x; -#ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES - v = std::move(x); -#else - v = x; -#endif + v = optional_detail::move(x); } else { From 7974207c7f148ab2f5489323f0509dd44c2b4a38 Mon Sep 17 00:00:00 2001 From: typenameTea Date: Sat, 5 Oct 2024 19:00:27 +0100 Subject: [PATCH 149/163] refactor: make include guard more unique --- include/boost/optional/detail/optional_utility.hpp | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/include/boost/optional/detail/optional_utility.hpp b/include/boost/optional/detail/optional_utility.hpp index a5ef508b..d17babb4 100644 --- a/include/boost/optional/detail/optional_utility.hpp +++ b/include/boost/optional/detail/optional_utility.hpp @@ -9,8 +9,8 @@ // You are welcome to contact the author at: // typenametea@gmail.com -#ifndef BOOST_OPTIONAL_OPTIONAL_DETAIL_OPTIONAL_UTILITY_HPP -#define BOOST_OPTIONAL_OPTIONAL_DETAIL_OPTIONAL_UTILITY_HPP +#ifndef BOOST_OPTIONAL_OPTIONAL_DETAIL_OPTIONAL_UTILITY_TNT_05OCT2024_HPP +#define BOOST_OPTIONAL_OPTIONAL_DETAIL_OPTIONAL_UTILITY_TNT_05OCT2024_HPP namespace boost { namespace optional_detail { From c8bd18d6dee9ca3cc41307cc8fdb5575df5ad399 Mon Sep 17 00:00:00 2001 From: Ryan Malcolm Underwood Date: Sun, 6 Oct 2024 20:13:05 +0100 Subject: [PATCH 150/163] refactor: update copyright, modify forward assert --- include/boost/optional/detail/optional_utility.hpp | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/include/boost/optional/detail/optional_utility.hpp b/include/boost/optional/detail/optional_utility.hpp index d17babb4..581a7e7c 100644 --- a/include/boost/optional/detail/optional_utility.hpp +++ b/include/boost/optional/detail/optional_utility.hpp @@ -1,4 +1,4 @@ -// Copyright (C) 2024 typenameTea. +// Copyright (C) 2024 Ryan Malcolm Underwood. // // Use, modification, and distribution is subject to the Boost Software // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at @@ -9,8 +9,8 @@ // You are welcome to contact the author at: // typenametea@gmail.com -#ifndef BOOST_OPTIONAL_OPTIONAL_DETAIL_OPTIONAL_UTILITY_TNT_05OCT2024_HPP -#define BOOST_OPTIONAL_OPTIONAL_DETAIL_OPTIONAL_UTILITY_TNT_05OCT2024_HPP +#ifndef BOOST_OPTIONAL_OPTIONAL_DETAIL_OPTIONAL_UTILITY_RMU_06OCT2024_HPP +#define BOOST_OPTIONAL_OPTIONAL_DETAIL_OPTIONAL_UTILITY_RMU_06OCT2024_HPP namespace boost { namespace optional_detail { @@ -25,7 +25,9 @@ inline constexpr T&& forward(typename boost::remove_reference::type& t) noexc template inline constexpr T&& forward(typename boost::remove_reference::type&& t) noexcept { - BOOST_STATIC_ASSERT_MSG(!boost::is_lvalue_reference::value, "Can not forward an rvalue as an lvalue."); +#ifndef BOOST_NO_CXX11_STATIC_ASSERT + static_assert(!boost::is_lvalue_reference::value, "Can not forward an rvalue as an lvalue."); +#endif return static_cast(t); } From b2c7f93ead745dd1d75d76432c3b2be03fa3e2c9 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Wed, 16 Oct 2024 22:51:06 +0200 Subject: [PATCH 151/163] Restore support for compilers without ref qualifiers --- include/boost/none_t.hpp | 13 +++- .../boost/optional/detail/optional_config.hpp | 13 +++- .../boost/optional/detail/optional_swap.hpp | 4 +- include/boost/optional/optional.hpp | 68 +++++++++---------- 4 files changed, 56 insertions(+), 42 deletions(-) diff --git a/include/boost/none_t.hpp b/include/boost/none_t.hpp index 0f95128f..1c8e0761 100644 --- a/include/boost/none_t.hpp +++ b/include/boost/none_t.hpp @@ -14,11 +14,18 @@ #define BOOST_NONE_T_17SEP2003_HPP #include +#include -#if defined (BOOST_NO_CXX11_RVALUE_REFERENCES) || defined(BOOST_NO_CXX11_VARIADIC_TEMPLATES) || defined(BOOST_NO_CXX11_REF_QUALIFIERS) \ -|| defined(BOOST_NO_CXX11_LAMBDAS) || defined(BOOST_NO_CXX11_DECLTYPE_N3276) || defined(BOOST_NO_CXX11_NOEXCEPT) || defined(BOOST_NO_CXX11_DELETED_FUNCTIONS) || defined(BOOST_NO_CXX11_DEFAULTED_FUNCTIONS) || defined(BOOST_NO_CXX11_DEFAULTED_MOVES) || defined(BOOST_NO_CXX11_EXPLICIT_CONVERSION_OPERATORS) +#if defined (BOOST_NO_CXX11_RVALUE_REFERENCES) || defined(BOOST_NO_CXX11_VARIADIC_TEMPLATES) \ +|| defined(BOOST_NO_CXX11_LAMBDAS) || defined(BOOST_NO_CXX11_DECLTYPE_N3276) \ +|| defined(BOOST_NO_CXX11_DELETED_FUNCTIONS) || defined(BOOST_NO_CXX11_DEFAULTED_FUNCTIONS) \ +|| defined(BOOST_NO_CXX11_EXPLICIT_CONVERSION_OPERATORS) || defined(BOOST_NO_CXX11_STATIC_ASSERT) -#error "Boost.Optional requires C++11 or later. If you have an older C++ version use Boost.Optional version 1.86 or earlier." +#error "Boost.Optional requires some C++11 features since version 1.87. If you have an older C++ version use Boost.Optional version 1.86 or earlier." + +#elif defined(BOOST_NO_CXX11_REF_QUALIFIERS) || defined(BOOST_NO_CXX11_NOEXCEPT) || defined(BOOST_NO_CXX11_DEFAULTED_MOVES) + +BOOST_PRAGMA_MESSAGE("C++03 support is deprecated in Boost.Optional 1.83 and will be removed in Boost.Optional 1.88.") #endif diff --git a/include/boost/optional/detail/optional_config.hpp b/include/boost/optional/detail/optional_config.hpp index 3e5e282f..b7ccc3e6 100644 --- a/include/boost/optional/detail/optional_config.hpp +++ b/include/boost/optional/detail/optional_config.hpp @@ -16,7 +16,7 @@ #include #include -#if (defined BOOST_NO_CXX11_RVALUE_REFERENCES) || (defined BOOST_OPTIONAL_CONFIG_NO_RVALUE_REFERENCES) +#if (defined BOOST_OPTIONAL_CONFIG_NO_RVALUE_REFERENCES) # define BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES #endif @@ -82,7 +82,7 @@ #endif // defined(__GNUC__) -#if (defined __GNUC__) && (!defined BOOST_NO_CXX11_RVALUE_REFERENCES) +#if (defined __GNUC__) // On some initial rvalue reference implementations GCC does it in a strange way, // preferring perfect-forwarding constructor to implicit copy constructor. @@ -132,4 +132,13 @@ #endif +#ifdef BOOST_NO_CXX11_REF_QUALIFIERS +# define BOOST_OPTIONAL_CONST_REF_QUAL const +# define BOOST_OPTIONAL_REF_QUAL +#else +# define BOOST_OPTIONAL_CONST_REF_QUAL const& +# define BOOST_OPTIONAL_REF_QUAL & +#endif + + #endif // header guard diff --git a/include/boost/optional/detail/optional_swap.hpp b/include/boost/optional/detail/optional_swap.hpp index 0c708c6c..f1d301b4 100644 --- a/include/boost/optional/detail/optional_swap.hpp +++ b/include/boost/optional/detail/optional_swap.hpp @@ -63,7 +63,7 @@ template <> struct swap_selector { template - static void optional_swap ( optional& x, optional& y ) + static void optional_swap ( optional& x, optional& y ) //BOOST_NOEXCEPT_IF(::boost::is_nothrow_move_constructible::value && BOOST_NOEXCEPT_EXPR(boost::core::invoke_swap(*x, *y))) { if (x) @@ -91,7 +91,7 @@ struct swap_selector } // namespace optional_detail -#if (!defined BOOST_NO_CXX11_RVALUE_REFERENCES) && (!defined BOOST_CONFIG_RESTORE_OBSOLETE_SWAP_IMPLEMENTATION) +#if (!defined BOOST_CONFIG_RESTORE_OBSOLETE_SWAP_IMPLEMENTATION) template struct optional_swap_should_use_default_constructor : boost::false_type {} ; diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 6aec3cec..afe42da8 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -580,7 +580,6 @@ struct is_optional_constructible : boost::true_type #if !defined(BOOST_NO_CXX11_DECLTYPE) && !BOOST_WORKAROUND(BOOST_MSVC, < 1800) // for is_assignable -#if (!defined BOOST_NO_CXX11_RVALUE_REFERENCES) // On some initial rvalue reference implementations GCC does it in a strange way, // preferring perfect-forwarding constructor to implicit copy constructor. @@ -591,15 +590,6 @@ struct is_opt_assignable #else -template -struct is_opt_assignable - : boost::conjunction, boost::is_assignable > -{}; - -#endif - -#else - template struct is_opt_assignable : boost::is_convertible {}; @@ -922,11 +912,14 @@ class optional // Returns a reference to the value if this is initialized, otherwise, // the behaviour is UNDEFINED // No-throw - reference_const_type operator *() const& { return this->get() ; } - reference_type operator *() & { return this->get() ; } + reference_const_type operator *() BOOST_OPTIONAL_CONST_REF_QUAL { return this->get() ; } + reference_type operator *() BOOST_OPTIONAL_REF_QUAL { return this->get() ; } + +#ifndef BOOST_NO_CXX11_REF_QUALIFIERS reference_type_of_temporary_wrapper operator *() && { return optional_detail::move(this->get()) ; } +#endif - reference_const_type value() const& + reference_const_type value() BOOST_OPTIONAL_CONST_REF_QUAL { if (this->is_initialized()) return this->get() ; @@ -934,7 +927,7 @@ class optional throw_exception(bad_optional_access()); } - reference_type value() & + reference_type value() BOOST_OPTIONAL_REF_QUAL { if (this->is_initialized()) return this->get() ; @@ -942,41 +935,40 @@ class optional throw_exception(bad_optional_access()); } - reference_type_of_temporary_wrapper value() && + template + value_type value_or ( U&& v ) BOOST_OPTIONAL_CONST_REF_QUAL { if (this->is_initialized()) - return optional_detail::move(this->get()) ; + return get(); else - throw_exception(bad_optional_access()); + return optional_detail::forward(v); } - - - template - value_type value_or ( U&& v ) const& + template + value_type value_or_eval ( F f ) BOOST_OPTIONAL_CONST_REF_QUAL { if (this->is_initialized()) return get(); else - return optional_detail::forward(v); + return f(); } - template - value_type value_or ( U&& v ) && +#ifndef BOOST_NO_CXX11_REF_QUALIFIERS + reference_type_of_temporary_wrapper value() && { if (this->is_initialized()) - return optional_detail::move(get()); + return optional_detail::move(this->get()) ; else - return optional_detail::forward(v); + throw_exception(bad_optional_access()); } - template - value_type value_or_eval ( F f ) const& + template + value_type value_or ( U&& v ) && { if (this->is_initialized()) - return get(); + return optional_detail::move(get()); else - return f(); + return optional_detail::forward(v); } template @@ -987,9 +979,12 @@ class optional else return f(); } +#endif + +// Monadic interface template - optional::type> map(F f) & + optional::type> map(F f) BOOST_OPTIONAL_REF_QUAL { if (this->has_value()) return f(get()); @@ -998,7 +993,7 @@ class optional } template - optional::type> map(F f) const& + optional::type> map(F f) BOOST_OPTIONAL_CONST_REF_QUAL { if (this->has_value()) return f(get()); @@ -1006,6 +1001,7 @@ class optional return none; } +#ifndef BOOST_NO_CXX11_REF_QUALIFIERS template optional::type> map(F f) && { @@ -1014,10 +1010,11 @@ class optional else return none; } +#endif template optional::type> - flat_map(F f) & + flat_map(F f) BOOST_OPTIONAL_REF_QUAL { if (this->has_value()) return f(get()); @@ -1027,7 +1024,7 @@ class optional template optional::type> - flat_map(F f) const& + flat_map(F f) BOOST_OPTIONAL_CONST_REF_QUAL { if (this->has_value()) return f(get()); @@ -1035,6 +1032,7 @@ class optional return none; } +#ifndef BOOST_NO_CXX11_REF_QUALIFIERS template optional::type> flat_map(F f) && @@ -1044,7 +1042,7 @@ class optional else return none; } - +#endif bool has_value() const BOOST_NOEXCEPT { return this->is_initialized() ; } From e601f1ef2d5ca3d5886399ab47a29e6f9df54100 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Wed, 16 Oct 2024 23:26:44 +0200 Subject: [PATCH 152/163] Drop dependency on Boost.StaticAssert --- CMakeLists.txt | 3 +- build.jam | 2 - doc/92_relnotes.qbk | 3 +- .../detail/optional_reference_spec.hpp | 12 +-- include/boost/optional/optional.hpp | 4 +- test/optional_test_convert_assign.cpp | 6 +- test/optional_test_convert_from_T.cpp | 16 ++-- test/optional_test_noexcept_move.cpp | 86 +++++++++---------- test/optional_test_path_assignment.cpp | 2 +- ...ref_convert_assign_const_int_prevented.cpp | 2 +- test/optional_test_sfinae_friendly_ctor.cpp | 24 +++--- 11 files changed, 78 insertions(+), 82 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index a91e7a03..80799e10 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -11,7 +11,7 @@ add_library(boost_optional INTERFACE) add_library(Boost::optional ALIAS boost_optional) target_include_directories(boost_optional INTERFACE include) -if(NOT CMAKE_VERSION VERSION_LESS "3.19") +if(NOT CMAKE_VERSION VERSION_LESS "3.19") file(GLOB_RECURSE headers include/*.hpp) target_sources(boost_optional PRIVATE ${headers}) endif() @@ -21,7 +21,6 @@ target_link_libraries(boost_optional Boost::assert Boost::config Boost::core - Boost::static_assert Boost::throw_exception Boost::type_traits ) diff --git a/build.jam b/build.jam index 6f1fcf6d..b08ea0b0 100644 --- a/build.jam +++ b/build.jam @@ -9,7 +9,6 @@ constant boost_dependencies : /boost/assert//boost_assert /boost/config//boost_config /boost/core//boost_core - /boost/static_assert//boost_static_assert /boost/throw_exception//boost_throw_exception /boost/type_traits//boost_type_traits ; @@ -22,4 +21,3 @@ explicit call-if : boost-library optional ; - diff --git a/doc/92_relnotes.qbk b/doc/92_relnotes.qbk index 649cad78..e5750753 100644 --- a/doc/92_relnotes.qbk +++ b/doc/92_relnotes.qbk @@ -13,9 +13,10 @@ [heading Boost Release 1.87] -* *Breaking change.* Dropped support for C++03. C++11 is now the required minimum. +* *Breaking change.* Dropped support for C++03. C++11 is now the required minimum; at least some C++11 features. * Dropped dependency on Boost.Utility. * Dropped dependency on Boost.Predef. +* Dropped dependency on Boost.StaticAssert. * Dropped dependency on Boost.Move. * A bit faster implementation of some relational operations. * Tags `in_place_init` and `in_place_init_if` become `inline constexpr` and therewith leave smaller footprint in the executable. This addresses [@https://github.com/boostorg/optional/issues/103 issue #103]. diff --git a/include/boost/optional/detail/optional_reference_spec.hpp b/include/boost/optional/detail/optional_reference_spec.hpp index 30824c26..d8405f82 100644 --- a/include/boost/optional/detail/optional_reference_spec.hpp +++ b/include/boost/optional/detail/optional_reference_spec.hpp @@ -29,16 +29,16 @@ template void prevent_binding_rvalue() { #ifndef BOOST_OPTIONAL_CONFIG_ALLOW_BINDING_TO_RVALUES - BOOST_STATIC_ASSERT_MSG(boost::is_lvalue_reference::value, - "binding rvalue references to optional lvalue references is disallowed"); + static_assert(boost::is_lvalue_reference::value, + "binding rvalue references to optional lvalue references is disallowed"); #endif } template BOOST_DEDUCED_TYPENAME boost::remove_reference::type& forward_reference(T&& r) { - BOOST_STATIC_ASSERT_MSG(boost::is_lvalue_reference::value, - "binding rvalue references to optional lvalue references is disallowed"); + static_assert(boost::is_lvalue_reference::value, + "binding rvalue references to optional lvalue references is disallowed"); return optional_detail::forward(r); } @@ -68,8 +68,8 @@ void prevent_assignment_from_false_const_integral() #ifdef BOOST_OPTIONAL_CONFIG_NO_PROPER_ASSIGN_FROM_CONST_INT // MSVC compiler without rvalue references: we need to disable the assignment from // const integral lvalue reference, as it may be an invalid temporary - BOOST_STATIC_ASSERT_MSG(!is_const_integral::value, - "binding const lvalue references to integral types is disabled in this compiler"); + static_assert(!is_const_integral::value, + "binding const lvalue references to integral types is disabled in this compiler"); #endif #endif } diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index afe42da8..0fd44480 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -1053,7 +1053,7 @@ class optional template class optional { - BOOST_STATIC_ASSERT_MSG(sizeof(T) == 0, "Optional rvalue references are illegal."); + static_assert(sizeof(T) == 0, "Optional rvalue references are illegal."); } ; } // namespace boost @@ -1163,7 +1163,7 @@ template std::basic_ostream& operator<<(std::basic_ostream& os, optional_detail::optional_tag const&) { - BOOST_STATIC_ASSERT_MSG(sizeof(CharType) == 0, "If you want to output boost::optional, include header "); + static_assert(sizeof(CharType) == 0, "If you want to output boost::optional, include header "); return os; } diff --git a/test/optional_test_convert_assign.cpp b/test/optional_test_convert_assign.cpp index 5e1cedac..a0675206 100644 --- a/test/optional_test_convert_assign.cpp +++ b/test/optional_test_convert_assign.cpp @@ -40,9 +40,9 @@ void test_no_bad_assignment() { #if !defined(BOOST_NO_CXX11_DECLTYPE) && !BOOST_WORKAROUND(BOOST_MSVC, < 1800) // this means that type trait `boost::is_assignable` works. - BOOST_STATIC_ASSERT((boost::is_assignable&, bool>::value)); - BOOST_STATIC_ASSERT((boost::is_assignable&, implicit_bool_conv>::value)); - BOOST_STATIC_ASSERT((! boost::is_assignable&, explicit_bool_conv>::value)); + static_assert((boost::is_assignable&, bool>::value), "ERROR"); + static_assert((boost::is_assignable&, implicit_bool_conv>::value), "ERROR"); + static_assert((! boost::is_assignable&, explicit_bool_conv>::value), "ERROR"); #endif } diff --git a/test/optional_test_convert_from_T.cpp b/test/optional_test_convert_from_T.cpp index bfa1a0aa..60f94cc7 100644 --- a/test/optional_test_convert_from_T.cpp +++ b/test/optional_test_convert_from_T.cpp @@ -28,14 +28,14 @@ struct superconv { #ifndef BOOST_OPTIONAL_DETAIL_NO_RVALUE_REFERENCES template - superconv(T&&) { BOOST_STATIC_ASSERT(sizeof(T) == 0); } + superconv(T&&) { static_assert(sizeof(T) == 0, "ERROR"); } #else template - superconv(const T&) { BOOST_STATIC_ASSERT(sizeof(T) == 0); } + superconv(const T&) { static_assert(sizeof(T) == 0, "ERROR"); } template - superconv( T&) { BOOST_STATIC_ASSERT(sizeof(T) == 0); } + superconv( T&) { static_assert(sizeof(T) == 0, "ERROR"); } #endif - + superconv() {} }; @@ -52,19 +52,19 @@ void test_optional_optional_T() { optional oi1 (1), oiN; optional< optional > ooi1 (oi1), ooiN(oiN); - + BOOST_TEST(ooi1); BOOST_TEST(*ooi1); BOOST_TEST_EQ(**ooi1, 1); - + BOOST_TEST(ooiN); BOOST_TEST(!*ooiN); -} +} int main() { test_optional_optional_T(); test_optional_of_superconverting_T(); - + return boost::report_errors(); } diff --git a/test/optional_test_noexcept_move.cpp b/test/optional_test_noexcept_move.cpp index bc4fa97a..6ff8a9a9 100644 --- a/test/optional_test_noexcept_move.cpp +++ b/test/optional_test_noexcept_move.cpp @@ -44,36 +44,36 @@ struct NothrowNone { #if 0 // these also test type_traits, which are wrong void test_noexcept_as_defined() // this is a compile-time test { - BOOST_STATIC_ASSERT(::boost::is_nothrow_move_constructible::value); - BOOST_STATIC_ASSERT(::boost::is_nothrow_move_assignable::value); - - BOOST_STATIC_ASSERT(::boost::is_nothrow_move_constructible::value); - BOOST_STATIC_ASSERT(!::boost::is_nothrow_move_assignable::value); - - BOOST_STATIC_ASSERT(!::boost::is_nothrow_move_constructible::value); - BOOST_STATIC_ASSERT(::boost::is_nothrow_move_assignable::value); - - BOOST_STATIC_ASSERT(!::boost::is_nothrow_move_constructible::value); - BOOST_STATIC_ASSERT(!::boost::is_nothrow_move_assignable::value); + static_assert(::boost::is_nothrow_move_constructible::value, "ERROR"); + static_assert(::boost::is_nothrow_move_assignable::value, "ERROR"); + + static_assert(::boost::is_nothrow_move_constructible::value, "ERROR"); + static_assert(!::boost::is_nothrow_move_assignable::value, "ERROR"); + + static_assert(!::boost::is_nothrow_move_constructible::value, "ERROR"); + static_assert(::boost::is_nothrow_move_assignable::value, "ERROR"); + + static_assert(!::boost::is_nothrow_move_constructible::value, "ERROR"); + static_assert(!::boost::is_nothrow_move_assignable::value, "ERROR"); } void test_noexcept_on_optional_with_type_traits() // this is a compile-time test { - BOOST_STATIC_ASSERT(::boost::is_nothrow_move_constructible >::value); - BOOST_STATIC_ASSERT(::boost::is_nothrow_move_assignable >::value); - BOOST_STATIC_ASSERT(BOOST_NOEXCEPT_EXPR(optional())); - - BOOST_STATIC_ASSERT(::boost::is_nothrow_move_constructible >::value); - BOOST_STATIC_ASSERT(!::boost::is_nothrow_move_assignable >::value); - BOOST_STATIC_ASSERT(BOOST_NOEXCEPT_EXPR(optional())); - - BOOST_STATIC_ASSERT(!::boost::is_nothrow_move_constructible >::value); - BOOST_STATIC_ASSERT(!::boost::is_nothrow_move_assignable >::value); - BOOST_STATIC_ASSERT(BOOST_NOEXCEPT_EXPR(optional())); - - BOOST_STATIC_ASSERT(!::boost::is_nothrow_move_constructible >::value); - BOOST_STATIC_ASSERT(!::boost::is_nothrow_move_assignable >::value); - BOOST_STATIC_ASSERT(BOOST_NOEXCEPT_EXPR(optional())); + static_assert(::boost::is_nothrow_move_constructible >::value, "ERROR"); + static_assert(::boost::is_nothrow_move_assignable >::value, "ERROR"); + static_assert(BOOST_NOEXCEPT_EXPR(optional()), "ERROR"); + + static_assert(::boost::is_nothrow_move_constructible >::value, "ERROR"); + static_assert(!::boost::is_nothrow_move_assignable >::value, "ERROR"); + static_assert(BOOST_NOEXCEPT_EXPR(optional()), "ERROR"); + + static_assert(!::boost::is_nothrow_move_constructible >::value, "ERROR"); + static_assert(!::boost::is_nothrow_move_assignable >::value, "ERROR"); + static_assert(BOOST_NOEXCEPT_EXPR(optional()), "ERROR"); + + static_assert(!::boost::is_nothrow_move_constructible >::value, "ERROR"); + static_assert(!::boost::is_nothrow_move_assignable >::value, "ERROR"); + static_assert(BOOST_NOEXCEPT_EXPR(optional()), "ERROR"); } #endif @@ -87,22 +87,22 @@ void test_noexcept_optional_with_operator() // compile-time test ONxC onxC; ONxA onxA; ONx0 onx0; - - BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( ONx2() )); - BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( ONx2(std::move(onx2)) )); - BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( onx2 = ONx2() )); - - BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( ONxC() )); - BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( ONxC(std::move(onxC)) )); - BOOST_STATIC_ASSERT(!BOOST_NOEXCEPT_EXPR( onxC = ONxC() )); - - BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( ONxA() )); - BOOST_STATIC_ASSERT(!BOOST_NOEXCEPT_EXPR( ONxA(std::move(onxA)) )); - BOOST_STATIC_ASSERT(!BOOST_NOEXCEPT_EXPR( onxA = ONxA() )); - - BOOST_STATIC_ASSERT( BOOST_NOEXCEPT_EXPR( ONx0() )); - BOOST_STATIC_ASSERT(!BOOST_NOEXCEPT_EXPR( ONx0(std::move(onx0)) )); - BOOST_STATIC_ASSERT(!BOOST_NOEXCEPT_EXPR( onx0 = ONx0() )); + + static_assert( BOOST_NOEXCEPT_EXPR( ONx2() ), "ERROR"); + static_assert( BOOST_NOEXCEPT_EXPR( ONx2(std::move(onx2)) ), "ERROR"); + static_assert( BOOST_NOEXCEPT_EXPR( onx2 = ONx2() ), "ERROR"); + + static_assert( BOOST_NOEXCEPT_EXPR( ONxC() ), "ERROR"); + static_assert( BOOST_NOEXCEPT_EXPR( ONxC(std::move(onxC)) ), "ERROR"); + static_assert(!BOOST_NOEXCEPT_EXPR( onxC = ONxC() ), "ERROR"); + + static_assert( BOOST_NOEXCEPT_EXPR( ONxA() ), "ERROR"); + static_assert(!BOOST_NOEXCEPT_EXPR( ONxA(std::move(onxA)) ), "ERROR"); + static_assert(!BOOST_NOEXCEPT_EXPR( onxA = ONxA() ), "ERROR"); + + static_assert( BOOST_NOEXCEPT_EXPR( ONx0() ), "ERROR"); + static_assert(!BOOST_NOEXCEPT_EXPR( ONx0(std::move(onx0)) ), "ERROR"); + static_assert(!BOOST_NOEXCEPT_EXPR( onx0 = ONx0() ), "ERROR"); } #endif // !defined BOOST_NO_CXX11_NOEXCEPT @@ -112,5 +112,3 @@ int main() { return 0; } - - diff --git a/test/optional_test_path_assignment.cpp b/test/optional_test_path_assignment.cpp index 485e741d..d8240d14 100644 --- a/test/optional_test_path_assignment.cpp +++ b/test/optional_test_path_assignment.cpp @@ -66,7 +66,7 @@ int main() optFs1 = optFs2; // the following still fails although it shouldn't - //BOOST_STATIC_ASSERT((std::is_copy_constructible>::value)); + //static_assert((std::is_copy_constructible>::value), "ERROR"); #endif #endif diff --git a/test/optional_test_ref_convert_assign_const_int_prevented.cpp b/test/optional_test_ref_convert_assign_const_int_prevented.cpp index e692475f..153e6a8c 100644 --- a/test/optional_test_ref_convert_assign_const_int_prevented.cpp +++ b/test/optional_test_ref_convert_assign_const_int_prevented.cpp @@ -26,7 +26,7 @@ int main() #ifdef BOOST_OPTIONAL_CONFIG_NO_PROPER_ASSIGN_FROM_CONST_INT test_converting_assignment(); #else - BOOST_STATIC_ASSERT_MSG(false, "EXPECTED TEST COMPILE-TIME FAILURE"); + static_assert(false, "EXPECTED TEST COMPILE-TIME FAILURE"); #endif return boost::report_errors(); } diff --git a/test/optional_test_sfinae_friendly_ctor.cpp b/test/optional_test_sfinae_friendly_ctor.cpp index c13bb2bb..2eff2ff7 100644 --- a/test/optional_test_sfinae_friendly_ctor.cpp +++ b/test/optional_test_sfinae_friendly_ctor.cpp @@ -21,29 +21,29 @@ using boost::optional; struct X {}; struct Y {}; - + struct Resource { explicit Resource(const X&) {} }; -BOOST_STATIC_ASSERT(( boost::is_constructible::value )); -BOOST_STATIC_ASSERT(( !boost::is_constructible::value )); +static_assert(( boost::is_constructible::value ), "ERROR"); +static_assert(( !boost::is_constructible::value ), "ERROR"); -BOOST_STATIC_ASSERT(( boost::is_constructible, const X&>::value )); -BOOST_STATIC_ASSERT(( !boost::is_constructible, const Y&>::value )); +static_assert(( boost::is_constructible, const X&>::value ), "ERROR"); +static_assert(( !boost::is_constructible, const Y&>::value ), "ERROR"); #ifndef BOOST_OPTIONAL_DETAIL_NO_SFINAE_FRIENDLY_CONSTRUCTORS -BOOST_STATIC_ASSERT(( boost::is_constructible< optional< optional >, optional >::value )); -BOOST_STATIC_ASSERT(( !boost::is_constructible< optional, optional< optional > >::value )); +static_assert(( boost::is_constructible< optional< optional >, optional >::value ), "ERROR"); +static_assert(( !boost::is_constructible< optional, optional< optional > >::value ), "ERROR"); -BOOST_STATIC_ASSERT(( boost::is_constructible< optional< optional >, const optional& >::value )); -BOOST_STATIC_ASSERT(( !boost::is_constructible< optional, const optional< optional >& >::value )); +static_assert(( boost::is_constructible< optional< optional >, const optional& >::value ), "ERROR"); +static_assert(( !boost::is_constructible< optional, const optional< optional >& >::value ), "ERROR"); -BOOST_STATIC_ASSERT(( boost::is_constructible, const optional&>::value )); -BOOST_STATIC_ASSERT(( !boost::is_constructible, const optional&>::value )); +static_assert(( boost::is_constructible, const optional&>::value ), "ERROR"); +static_assert(( !boost::is_constructible, const optional&>::value ), "ERROR"); #endif - + #endif int main() { } From 5e7fdf5ec5eca7b562dd1a56409f49e7ed2d1896 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Wed, 16 Oct 2024 23:42:56 +0200 Subject: [PATCH 153/163] Clean remnants of StaticAssert and mpl --- include/boost/optional/detail/optional_utility.hpp | 2 -- include/boost/optional/optional.hpp | 1 - test/CMakeLists.txt | 2 +- test/Jamfile.v2 | 4 ++-- test/optional_test.cpp | 2 -- test/optional_test_noexcept_move.cpp | 1 - 6 files changed, 3 insertions(+), 9 deletions(-) diff --git a/include/boost/optional/detail/optional_utility.hpp b/include/boost/optional/detail/optional_utility.hpp index 581a7e7c..f7c04ffe 100644 --- a/include/boost/optional/detail/optional_utility.hpp +++ b/include/boost/optional/detail/optional_utility.hpp @@ -25,9 +25,7 @@ inline constexpr T&& forward(typename boost::remove_reference::type& t) noexc template inline constexpr T&& forward(typename boost::remove_reference::type&& t) noexcept { -#ifndef BOOST_NO_CXX11_STATIC_ASSERT static_assert(!boost::is_lvalue_reference::value, "Can not forward an rvalue as an lvalue."); -#endif return static_cast(t); } diff --git a/include/boost/optional/optional.hpp b/include/boost/optional/optional.hpp index 0fd44480..b8f402d8 100644 --- a/include/boost/optional/optional.hpp +++ b/include/boost/optional/optional.hpp @@ -28,7 +28,6 @@ #include #include #include -#include #include #include #include diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt index eedb6f8c..9a030809 100644 --- a/test/CMakeLists.txt +++ b/test/CMakeLists.txt @@ -6,6 +6,6 @@ include(BoostTestJamfile OPTIONAL RESULT_VARIABLE HAVE_BOOST_TEST) if(HAVE_BOOST_TEST) -boost_test_jamfile(FILE Jamfile.v2 LINK_LIBRARIES Boost::optional Boost::core Boost::bind Boost::mpl Boost::tuple) +boost_test_jamfile(FILE Jamfile.v2 LINK_LIBRARIES Boost::optional Boost::core Boost::bind Boost::tuple) endif() diff --git a/test/Jamfile.v2 b/test/Jamfile.v2 index 33c3f25f..21ea8d38 100644 --- a/test/Jamfile.v2 +++ b/test/Jamfile.v2 @@ -26,14 +26,14 @@ project cxx11_defaulted_moves cxx11_deleted_functions cxx11_explicit_conversion_operators - cxx11_noexcept +# cxx11_noexcept cxx11_rvalue_references cxx11_variadic_templates ] ; -run optional_test.cpp : : : /boost/bind//boost_bind /boost/mpl//boost_mpl ; +run optional_test.cpp : : : /boost/bind//boost_bind ; run optional_test_assign.cpp ; run optional_test_swap.cpp ; compile optional_test_wuninitialized.cpp ; diff --git a/test/optional_test.cpp b/test/optional_test.cpp index bd8f90fc..b7d96039 100644 --- a/test/optional_test.cpp +++ b/test/optional_test.cpp @@ -24,8 +24,6 @@ #if !defined(BOOST_NO_CXX11_VARIADIC_TEMPLATES) && !defined(BOOST_NO_CXX11_RVALUE_REFERENCES) #include "boost/bind/apply.hpp" // Included just to test proper interaction with boost::apply<> as reported by Daniel Wallin #endif -#include "boost/mpl/bool.hpp" -#include "boost/mpl/bool_fwd.hpp" // For mpl::true_ and mpl::false_ #include "boost/optional/optional.hpp" diff --git a/test/optional_test_noexcept_move.cpp b/test/optional_test_noexcept_move.cpp index 6ff8a9a9..3aba93ae 100644 --- a/test/optional_test_noexcept_move.cpp +++ b/test/optional_test_noexcept_move.cpp @@ -9,7 +9,6 @@ // You are welcome to contact the author at: // akrzemi1@gmail.com -#include "boost/static_assert.hpp" #include "boost/optional/optional.hpp" #ifdef BOOST_BORLANDC From 86f3288312d9e5f24699ce4e15afec041ea3caf4 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 17 Oct 2024 00:21:26 +0200 Subject: [PATCH 154/163] fix swap tests --- test/optional_test_inplace_fail.cpp | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/test/optional_test_inplace_fail.cpp b/test/optional_test_inplace_fail.cpp index 38722baf..c66effd1 100644 --- a/test/optional_test_inplace_fail.cpp +++ b/test/optional_test_inplace_fail.cpp @@ -31,10 +31,10 @@ struct Guard std::string str; Guard() : num() {} Guard(double num_, std::string str_) : num(num_), str(str_) {} - + friend bool operator==(const Guard& lhs, const Guard& rhs) { return lhs.num == rhs.num && lhs.str == rhs.str; } friend bool operator!=(const Guard& lhs, const Guard& rhs) { return !(lhs == rhs); } - + private: Guard(const Guard&); Guard& operator=(const Guard&); @@ -50,4 +50,4 @@ int main() NOTHING_TO_TEST_SO_JUST_FAIL #endif return 0; -} \ No newline at end of file +} From b8fd0bcb5f1547f4ab22d5e6fc694b60e1af5af4 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 17 Oct 2024 07:15:01 +0200 Subject: [PATCH 155/163] fix swap tests --- test/optional_test_swap.cpp | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/test/optional_test_swap.cpp b/test/optional_test_swap.cpp index d997ef6c..bdd629a9 100644 --- a/test/optional_test_swap.cpp +++ b/test/optional_test_swap.cpp @@ -15,7 +15,6 @@ // #include "boost/optional/optional.hpp" -#include "boost/utility/in_place_factory.hpp" #ifdef BOOST_BORLANDC #pragma hdrstop @@ -189,9 +188,9 @@ namespace optional_swap_test return; if( !hasX ) - x = boost::in_place('\0'); + x.emplace('\0'); else if ( !hasY ) - y = boost::in_place('\0'); + y.emplace('\0'); optional_swap_test::swap(*x,*y); From eab3caf7edbe2e9876b7fd5a9dcb61ec05823ee8 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 17 Oct 2024 18:47:18 +0200 Subject: [PATCH 156/163] indicate that tests depend on utility --- test/CMakeLists.txt | 2 +- test/Jamfile.v2 | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt index 9a030809..e3df6bb8 100644 --- a/test/CMakeLists.txt +++ b/test/CMakeLists.txt @@ -6,6 +6,6 @@ include(BoostTestJamfile OPTIONAL RESULT_VARIABLE HAVE_BOOST_TEST) if(HAVE_BOOST_TEST) -boost_test_jamfile(FILE Jamfile.v2 LINK_LIBRARIES Boost::optional Boost::core Boost::bind Boost::tuple) +boost_test_jamfile(FILE Jamfile.v2 LINK_LIBRARIES Boost::optional Boost::core Boost::bind Boost::tuple Boost::utility) endif() diff --git a/test/Jamfile.v2 b/test/Jamfile.v2 index 21ea8d38..94e48801 100644 --- a/test/Jamfile.v2 +++ b/test/Jamfile.v2 @@ -56,7 +56,7 @@ run optional_test_ref_convert_assign_const_int.cpp ; run optional_test_ref_portable_minimum.cpp ; run optional_test_ref_move.cpp ; run optional_test_ref_to_val.cpp ; -run optional_test_inplace_factory.cpp ; +run optional_test_inplace_factory.cpp : : : /boost/utility//in_place_factories ; run optional_test_io.cpp ; run optional_test_move.cpp ; run optional_test_noexcept_move.cpp ; @@ -93,7 +93,7 @@ compile-fail optional_test_fail_io_without_io.cpp ; compile-fail optional_test_fail_none_io_without_io.cpp ; compile-fail optional_test_fail_convert_assign_of_enums.cpp ; run optional_test_static_properties.cpp ; -compile optional_test_maybe_uninitialized_warning.cpp ; +compile optional_test_maybe_uninitialized_warning.cpp ; : : : /boost/bind//boost_bind compile optional_test_deleted_default_ctor.cpp ; compile optional_test_constructible_from_other.cpp ; #run optional_xconfig_HACK_TO_LIST_PREDEFINED_MACROS.cpp ; From d5a0e294a7b9ffca4cef78618f80e04855238ad2 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 17 Oct 2024 19:00:04 +0200 Subject: [PATCH 157/163] Revert "indicate that tests depend on utility" This reverts commit eab3caf7edbe2e9876b7fd5a9dcb61ec05823ee8. --- test/CMakeLists.txt | 2 +- test/Jamfile.v2 | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt index e3df6bb8..9a030809 100644 --- a/test/CMakeLists.txt +++ b/test/CMakeLists.txt @@ -6,6 +6,6 @@ include(BoostTestJamfile OPTIONAL RESULT_VARIABLE HAVE_BOOST_TEST) if(HAVE_BOOST_TEST) -boost_test_jamfile(FILE Jamfile.v2 LINK_LIBRARIES Boost::optional Boost::core Boost::bind Boost::tuple Boost::utility) +boost_test_jamfile(FILE Jamfile.v2 LINK_LIBRARIES Boost::optional Boost::core Boost::bind Boost::tuple) endif() diff --git a/test/Jamfile.v2 b/test/Jamfile.v2 index 94e48801..21ea8d38 100644 --- a/test/Jamfile.v2 +++ b/test/Jamfile.v2 @@ -56,7 +56,7 @@ run optional_test_ref_convert_assign_const_int.cpp ; run optional_test_ref_portable_minimum.cpp ; run optional_test_ref_move.cpp ; run optional_test_ref_to_val.cpp ; -run optional_test_inplace_factory.cpp : : : /boost/utility//in_place_factories ; +run optional_test_inplace_factory.cpp ; run optional_test_io.cpp ; run optional_test_move.cpp ; run optional_test_noexcept_move.cpp ; @@ -93,7 +93,7 @@ compile-fail optional_test_fail_io_without_io.cpp ; compile-fail optional_test_fail_none_io_without_io.cpp ; compile-fail optional_test_fail_convert_assign_of_enums.cpp ; run optional_test_static_properties.cpp ; -compile optional_test_maybe_uninitialized_warning.cpp ; : : : /boost/bind//boost_bind +compile optional_test_maybe_uninitialized_warning.cpp ; compile optional_test_deleted_default_ctor.cpp ; compile optional_test_constructible_from_other.cpp ; #run optional_xconfig_HACK_TO_LIST_PREDEFINED_MACROS.cpp ; From 5ad8b01512a9ad14f49eaecd49f90a5b79e7263e Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 17 Oct 2024 19:22:21 +0200 Subject: [PATCH 158/163] add cmake dependency on Utils --- test/CMakeLists.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt index 9a030809..e3df6bb8 100644 --- a/test/CMakeLists.txt +++ b/test/CMakeLists.txt @@ -6,6 +6,6 @@ include(BoostTestJamfile OPTIONAL RESULT_VARIABLE HAVE_BOOST_TEST) if(HAVE_BOOST_TEST) -boost_test_jamfile(FILE Jamfile.v2 LINK_LIBRARIES Boost::optional Boost::core Boost::bind Boost::tuple) +boost_test_jamfile(FILE Jamfile.v2 LINK_LIBRARIES Boost::optional Boost::core Boost::bind Boost::tuple Boost::utility) endif() From c716bc552b688bc1030663fd15f2ddf53067612b Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Thu, 17 Oct 2024 20:26:17 +0200 Subject: [PATCH 159/163] add dep on static_assert to the jam file --- test/Jamfile.v2 | 1 + 1 file changed, 1 insertion(+) diff --git a/test/Jamfile.v2 b/test/Jamfile.v2 index 21ea8d38..af8e8310 100644 --- a/test/Jamfile.v2 +++ b/test/Jamfile.v2 @@ -28,6 +28,7 @@ project cxx11_explicit_conversion_operators # cxx11_noexcept cxx11_rvalue_references + cxx11_static_assert cxx11_variadic_templates ] ; From 121f3efde91de78ca018019904732f55d33b5788 Mon Sep 17 00:00:00 2001 From: Andrzej Krzemienski Date: Wed, 4 Dec 2024 00:23:27 +0100 Subject: [PATCH 160/163] add note about range interface to the relnotes --- doc/92_relnotes.qbk | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/doc/92_relnotes.qbk b/doc/92_relnotes.qbk index e5750753..7d0df4cc 100644 --- a/doc/92_relnotes.qbk +++ b/doc/92_relnotes.qbk @@ -19,6 +19,10 @@ * Dropped dependency on Boost.StaticAssert. * Dropped dependency on Boost.Move. * A bit faster implementation of some relational operations. +* *Warning.* In the future releases we intend to introduce the range interface + into `optional`, so that `std::ranges::range>` will be `true`. + This may affect the overload resolution in programs that make decisions based + on predicates such as `std::ranges::range`. * Tags `in_place_init` and `in_place_init_if` become `inline constexpr` and therewith leave smaller footprint in the executable. This addresses [@https://github.com/boostorg/optional/issues/103 issue #103]. From 6134d0c274f57ed795a5bc10612fa48a8d634cfe Mon Sep 17 00:00:00 2001 From: Alexander Grund Date: Sat, 7 Dec 2024 19:43:22 +0100 Subject: [PATCH 161/163] Fix node 20 issue on GHA CI --- .github/workflows/ci.yml | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index e8ad7c7e..67fa5429 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -10,7 +10,6 @@ on: env: UBSAN_OPTIONS: print_stacktrace=1 - ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION: true jobs: posix: @@ -161,20 +160,28 @@ jobs: os: macos-13 runs-on: ${{matrix.os}} - container: ${{matrix.container}} + container: + image: ${{matrix.container}} + volumes: + - /node20217:/node20217:rw,rshared + - ${{ startsWith(matrix.container, 'ubuntu:1') && '/node20217:/__e/node20:ro,rshared' || ' ' }} defaults: run: shell: bash steps: - - uses: actions/checkout@v3 - - name: Setup container environment if: matrix.container run: | apt-get update - apt-get -y install sudo python3 git g++ + apt-get -y install sudo python3 git g++ curl + if [[ "${{matrix.container}}" == "ubuntu:1"* ]]; then + # Node 20 doesn't work with Ubuntu 16/18 glibc: https://github.com/actions/checkout/issues/1590 + curl -sL https://unofficial-builds.nodejs.org/download/release/v20.9.0/node-v20.9.0-linux-x64-glibc-217.tar.xz | tar -xJ --strip-components 1 -C /node20217 + fi + + - uses: actions/checkout@v4 - name: Install packages if: matrix.install From 1a8c2dcafd715c6e989897db72bae8dbfd62927f Mon Sep 17 00:00:00 2001 From: Alexander Grund Date: Sun, 8 Dec 2024 13:11:03 +0100 Subject: [PATCH 162/163] Use hosted node --- .github/workflows/ci.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 67fa5429..8ea82672 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -178,7 +178,7 @@ jobs: apt-get -y install sudo python3 git g++ curl if [[ "${{matrix.container}}" == "ubuntu:1"* ]]; then # Node 20 doesn't work with Ubuntu 16/18 glibc: https://github.com/actions/checkout/issues/1590 - curl -sL https://unofficial-builds.nodejs.org/download/release/v20.9.0/node-v20.9.0-linux-x64-glibc-217.tar.xz | tar -xJ --strip-components 1 -C /node20217 + curl -sL https://archives.boost.io/misc/node/node-v20.9.0-linux-x64-glibc-217.tar.xz | tar -xJ --strip-components 1 -C /node20217 fi - uses: actions/checkout@v4 From e1c6b5b737ba5d7f7c158888d849639e93ebf09b Mon Sep 17 00:00:00 2001 From: Alexander Grund Date: Sun, 8 Dec 2024 14:43:18 +0100 Subject: [PATCH 163/163] Update containers --- .github/workflows/ci.yml | 12 +++--------- 1 file changed, 3 insertions(+), 9 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 8ea82672..bf415cb5 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -68,8 +68,7 @@ jobs: address-model: 32,64 - toolset: gcc-13 cxxstd: "03,11,14,17,20,2b" - os: ubuntu-latest - container: ubuntu:23.04 + os: ubuntu-24.04 install: g++-13-multilib address-model: 32,64 - toolset: clang @@ -143,18 +142,13 @@ jobs: - toolset: clang compiler: clang++-16 cxxstd: "03,11,14,17,20,2b" - container: ubuntu:23.04 - os: ubuntu-latest + os: ubuntu-24.04 install: clang-16 - toolset: clang compiler: clang++-17 cxxstd: "03,11,14,17,20,2b" - container: ubuntu:23.10 - os: ubuntu-latest + os: ubuntu-24.04 install: clang-17 - - toolset: clang - cxxstd: "03,11,14,17,20,2b" - os: macos-12 - toolset: clang cxxstd: "03,11,14,17,20,2b" os: macos-13