feat: datastore

Author: vinniefalco

include/boost/rts/datastore.hpp

@@ -0,0 +1,33 @@
+//
+// Copyright (c) 2025 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// 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)
+//
+// Official repository: https://github.com/cppalliance/rts
+//
+
+#ifndef BOOST_RTS_DATASTORE_HPP
+#define BOOST_RTS_DATASTORE_HPP
+
+#include <boost/rts/detail/config.hpp>
+#include <boost/rts/polystore.hpp>
+
+namespace boost {
+namespace rts {
+
+class datastore : public polystore
+{
+public:
+    datastore() = default;
+
+    void clear() noexcept  
+    {
+        polystore::clear();
+    }
+};
+
+} // rts
+} // boost
+
+#endif

include/boost/rts/polystore.hpp

@@ -181,15 +181,6 @@ class polystore
     */
     polystore() = default;
 
-    /** Remove and destroy all objects in the container.
-
-        All stored objects are destroyed in the reverse order
-        of construction. The container is left empty.
-    */
-    BOOST_RTS_DECL
-    void
-    clear() noexcept;
-
     /** Return a pointer to the object associated with type `T`, or `nullptr`
 
         If no object associated with `T` exists in the container,
@@ -499,6 +490,22 @@ class polystore
     struct any;
     class elements;
 
+    /** Remove and destroy all objects in the container.
+
+        All stored objects are destroyed in the reverse order
+        of construction. The container is left empty.
+    */
+    BOOST_RTS_DECL
+    void
+    clear() noexcept;
+
+    /** Return a range of all stored elements
+        @par Thread Safety
+        `const` member function calls are thread-safe.
+        Calls to non-`const` member functions must not run concurrently
+        with other member functions on the same object.
+        @return An object representing the range of stored elements.
+    */
     BOOST_RTS_DECL
     elements
     get_elements() noexcept;

src/datastore.cpp

@@ -0,0 +1,17 @@
+//
+// Copyright (c) 2025 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// 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)
+//
+// Official repository: https://github.com/cppalliance/rts
+//
+
+#include <boost/rts/datastore.hpp>
+#include <utility>
+
+namespace boost {
+namespace rts {
+
+} // rts
+} // boost

test/unit/datastore.cpp

@@ -0,0 +1,36 @@
+//
+// Copyright (c) 2025 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// 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)
+//
+// Official repository: https://github.com/cppalliance/rts
+//
+
+// Test that header file is self-contained.
+#include <boost/rts/datastore.hpp>
+
+#include "test_suite.hpp"
+
+namespace boost {
+namespace rts {
+
+struct datastore_test
+{
+    void run()
+    {
+        struct T{};
+
+        datastore ds; 
+        BOOST_TEST_EQ( ds.find<T>(), nullptr );
+        BOOST_TEST_NO_THROW( ds.emplace<T>() );
+        BOOST_TEST_NE( ds.find<T>(), nullptr );
+        ds.clear();
+        BOOST_TEST_EQ( ds.find<T>(), nullptr );
+    }
+};
+
+TEST_SUITE(datastore_test, "boost.rts.datastore");
+
+} // rts
+} // boost