Add "take" example

Author: lefticus

include/lefticus/tools/forwarding_ref.hpp

@@ -50,6 +50,7 @@ template<typename T> struct [[nodiscard]] forwarding_ref
 
   [[nodiscard]] explicit constexpr forwarding_ref(reference_type ref_ LIFETIMEBOUND) noexcept : ref{ &ref_ } {}
   [[nodiscard]] constexpr operator reference_type() noexcept LIFETIMEBOUND { return static_cast<reference_type>(*ref); }
+  [[nodiscard]] constexpr reference_type take() noexcept LIFETIMEBOUND { return static_cast<reference_type>(*ref); }
 
 private:
   pointer_type ref;

include/lefticus/tools/moving_ref.hpp

@@ -58,6 +58,8 @@ struct [[nodiscard]] moving_ref
   moving_ref(const T &) = delete ("this type is only to be used with rvalue reference parameters");
 
   [[nodiscard]] constexpr operator reference_type() noexcept LIFETIMEBOUND { return static_cast<reference_type>(*ref); }
+  [[nodiscard]] constexpr reference_type take() noexcept LIFETIMEBOUND { return static_cast<reference_type>(*ref); }
+
 
 private:
   pointer_type ref;

test/moving_forwarding_ref.cpp

@@ -75,6 +75,17 @@ template<typename T> constexpr auto can_construct_const()
   return requires(const T mct) { T{ lefticus::tools::moving_ref<T>{ std::move(mct) } }; };
 }
 
+TEST_CASE("[forwarding_ref] take() behaves as expected")
+{
+  [] () consteval {
+    auto use_forwarding_ref = []<typename T>(lefticus::tools::forwarding_ref<T> data) {
+      std::string(data.take());
+    };
+
+    use_forwarding_ref(lefticus::tools::forwarding_ref{"Hello World"});
+  }();
+}
+
 
 TEST_CASE("[forwarding_ref] behaves as expected")
 {