Add support for [[nodiscard]]:

- Decorate container and allocator functions.
- Make sure to disable warnings in tests
- Update doxygen documentation to support it

test/devector_test.cpp

@@ -1844,7 +1844,7 @@ template <class Devector> void test_at()
       a.at(0) = T(100);
       BOOST_TEST(a.at(0) == 100);
 
-      BOOST_TEST_THROWS(a.at(3), std::out_of_range);
+      BOOST_TEST_THROWS((void)a.at(3), std::out_of_range);
    }
 
    { // const at
@@ -1853,7 +1853,7 @@ template <class Devector> void test_at()
 
       BOOST_TEST(a.at(0) == 1);
 
-      BOOST_TEST_THROWS(a.at(3), std::out_of_range);
+      BOOST_TEST_THROWS((void)a.at(3), std::out_of_range);
    }
    #endif   //#ifndef BOOST_NO_EXCEPTIONS
 }

test/set_test.hpp

@@ -19,6 +19,11 @@
 #include <boost/move/iterator.hpp>
 #include <boost/move/make_unique.hpp>
 
+#if defined(BOOST_GCC) && (BOOST_GCC >= 40500)
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wunused-result"
+#endif
+
 #define BOOST_INTRUSIVE_HAS_MEMBER_FUNCTION_CALLABLE_WITH_FUNCNAME rebalance
 #define BOOST_INTRUSIVE_HAS_MEMBER_FUNCTION_CALLABLE_WITH_NS_BEG namespace boost { namespace container { namespace test {
 #define BOOST_INTRUSIVE_HAS_MEMBER_FUNCTION_CALLABLE_WITH_NS_END   }}}
@@ -26,6 +31,11 @@
 #define BOOST_INTRUSIVE_HAS_MEMBER_FUNCTION_CALLABLE_WITH_MAX 0
 #include <boost/intrusive/detail/has_member_function_callable_with.hpp>
 
+//#pragma GCC diagnostic ignored "-Wunused-result"
+#if defined(BOOST_GCC) && (BOOST_GCC >= 40500)
+#pragma GCC diagnostic pop
+#endif
+
 namespace boost{
 namespace container {
 namespace test{

test/static_vector_test.cpp

@@ -25,7 +25,7 @@ void test_ctor_ndc()
    BOOST_TEST_EQ(s.size() , 0u);
    BOOST_TEST(s.capacity() == N);
    BOOST_TEST(s.max_size() == N);
-   BOOST_TEST_THROWS( s.at(0u), std::out_of_range );
+   BOOST_TEST_THROWS( (void)s.at(0u), std::out_of_range );
 }
 
 template <typename T, size_t N>
@@ -36,7 +36,7 @@ void test_ctor_nc(size_t n)
    BOOST_TEST(s.size() == n);
    BOOST_TEST(s.capacity() == N);
    BOOST_TEST(s.max_size() == N);
-   BOOST_TEST_THROWS( s.at(n), std::out_of_range );
+   BOOST_TEST_THROWS( (void)s.at(n), std::out_of_range );
    if ( 1 < n )
    {
       s[0] = 10;
@@ -55,7 +55,7 @@ void test_ctor_nd(size_t n, T const& v)
    BOOST_STATIC_ASSERT((static_vector<T, N>::static_capacity) == N);
    BOOST_TEST(s.size() == n);
    BOOST_TEST(s.capacity() == N);
-   BOOST_TEST_THROWS( s.at(n), std::out_of_range );
+   BOOST_TEST_THROWS( (void)s.at(n), std::out_of_range );
    if ( 1 < n )
    {
       BOOST_TEST(v == s[0]);
@@ -114,7 +114,7 @@ void test_resize_nc(size_t n)
    s.resize(n);
    BOOST_TEST(s.size() == n);
    BOOST_TEST(s.capacity() == N);
-   BOOST_TEST_THROWS( s.at(n), std::out_of_range );
+   BOOST_TEST_THROWS( (void)s.at(n), std::out_of_range );
    if ( 1 < n )
    {
       s[0] = 10;
@@ -134,7 +134,7 @@ void test_resize_nd(size_t n, T const& v)
    s.resize(n, v);
    BOOST_TEST(s.size() == n);
    BOOST_TEST(s.capacity() == N);
-   BOOST_TEST_THROWS( s.at(n), std::out_of_range );
+   BOOST_TEST_THROWS( (void)s.at(n), std::out_of_range );
    if ( 1 < n )
    {
       BOOST_TEST(v == s[0]);
@@ -156,14 +156,14 @@ void test_push_back_nd()
    static_vector<T, N> s;
 
    BOOST_TEST(s.size() == 0);
-   BOOST_TEST_THROWS( s.at(0), std::out_of_range );
+   BOOST_TEST_THROWS( (void)s.at(0), std::out_of_range );
 
    for ( size_t i = 0 ; i < N ; ++i )
    {
       T t(static_cast<int>(i));
       s.push_back(t);
       BOOST_TEST(s.size() == i + 1);
-      BOOST_TEST_THROWS( s.at(i + 1), std::out_of_range );
+      BOOST_TEST_THROWS( (void)s.at(i + 1), std::out_of_range );
       BOOST_TEST(T((int)i) == s.at(i));
       BOOST_TEST(T((int)i) == s[i]);
       BOOST_TEST(T((int)i) == s.back());
@@ -187,7 +187,7 @@ void test_pop_back_nd()
    {
       s.pop_back();
       BOOST_TEST(s.size() == i - 1);
-      BOOST_TEST_THROWS( s.at(i - 1), std::out_of_range );
+      BOOST_TEST_THROWS( (void)s.at(i - 1), std::out_of_range );
       BOOST_TEST(T((int)i - 2) == s.at(i - 2));
       BOOST_TEST(T((int)i - 2) == s[i - 2]);
       BOOST_TEST(T((int)i - 2) == s.back());
@@ -418,7 +418,7 @@ void test_capacity_0_nd()
    static_vector_0_t s;
    BOOST_TEST(s.size() == 0);
    BOOST_TEST(s.capacity() == 0);
-   BOOST_TEST_THROWS(s.at(0), std::out_of_range);
+   BOOST_TEST_THROWS((void)s.at(0), std::out_of_range);
    BOOST_TEST_THROWS(s.resize(5u, T(0)), std::bad_alloc);
    BOOST_TEST_THROWS(s.push_back(T(0)), std::bad_alloc);
    BOOST_TEST_THROWS(s.insert(s.end(), T(0)), std::bad_alloc);