Add utilities (#8)

* algorithms

* scope exit

* tests

* oh yeah, 'unordered' map

* move curly

include/ncutility/Algorithm.h

@@ -0,0 +1,24 @@
+#pragma once
+
+#include "detail/EnumerateDetail.h"
+
+#include <algorithm>
+#include <type_traits>
+#include <vector>
+
+namespace nc::algo
+{
+/** @brief Wrapper around std::transform that returns transformed data in a new vector. */
+template<class T, std::invocable<const T&> UnaryOperation>
+auto Transform(const std::vector<T>& container, UnaryOperation op)
+{
+    using transformed_t = std::remove_cvref_t<std::invoke_result_t<UnaryOperation, const T&>>;
+    auto out = std::vector<transformed_t>{};
+    out.reserve(container.size());
+    std::transform(std::cbegin(container), std::cend(container), std::back_inserter(out), op);
+    return out;
+}
+
+/** @brief Implementation of std::enumerate. Obtain a view of [index, value] pairs from a range. */
+inline detail::enumerate_view_fn Enumerate;
+} // namespace nc::algo

include/ncutility/ScopeExit.h

@@ -0,0 +1,38 @@
+#pragma once
+
+namespace nc::detail
+{
+template <class F>
+class ScopeExit
+{
+public:
+    explicit ScopeExit(const F& onExit) noexcept
+        : m_func{onExit}
+    {
+    }
+
+    explicit ScopeExit(F&& onExit) noexcept
+        : m_func{std::move(onExit)}
+    {
+    }
+
+    ~ScopeExit() noexcept
+    {
+        m_func();
+    }
+
+    ScopeExit(ScopeExit&&) = delete;
+    ScopeExit(const ScopeExit&) = delete;
+    void operator=(const ScopeExit&) = delete;
+    void operator=(ScopeExit&&) = delete;
+
+private:
+    F m_func;
+};
+} // namespace nc::detail
+
+#define UNIQUE_NAME_HELPER(name, lineNumber) name ## lineNumber
+#define UNIQUE_NAME(name, lineNumber) UNIQUE_NAME_HELPER(name, lineNumber)
+
+/** @brief Create an RAII object in the current stack scope that executes 'body' on destruction. */
+#define SCOPE_EXIT(body) auto UNIQUE_NAME(localScopeExitFunc, __LINE__) = nc::detail::ScopeExit([&](){body;});