✨ Added a function to round a number to n decimal places

include/fiction/utils/round_n_decimal_places.hpp

@@ -0,0 +1,31 @@
+//
+// Created by Jan Drewniok on 19.04.23.
+//
+
+#ifndef FICTION_ROUND_N_DECIMAL_PLACES_HPP
+#define FICTION_ROUND_N_DECIMAL_PLACES_HPP
+
+#include <cmath>
+
+namespace fiction
+{
+
+/**
+ * Rounds a number to a specified number of decimal places.
+ *
+ * @tparam T the type of the number to round.
+ * @param number the number to round.
+ * @param n the number of decimal places to round to.
+ * @return the number rounded to n decimal places.
+ */
+
+template <typename T>
+T round_n_decimal_places(T number, const uint64_t n)
+{
+    T factor = std::pow(10, n);
+    return std::round(number * factor) / factor;
+}
+
+}  // namespace fiction
+
+#endif  // FICTION_ROUND_N_DECIMAL_PLACES_HPP

test/utils/round_n_decimal_places.cpp

@@ -0,0 +1,50 @@
+//
+// Created by Jan Drewniok on 19.04.23.
+//
+
+#include <catch2/catch_test_macros.hpp>
+
+#include <fiction/utils/round_n_decimal_places.hpp>
+
+using namespace fiction;
+
+TEST_CASE("round_n_decimal_places should round an input number to n decimal places", "[round_n_decimal_places]")
+{
+    SECTION("int64_t")
+    {
+        CHECK(round_n_decimal_places(-1LL, 0) == -1LL);
+        CHECK(round_n_decimal_places(-1LL, 10) == -1LL);
+        CHECK(round_n_decimal_places(1LL, 0) == 1LL);
+        CHECK(round_n_decimal_places(1LL, 10) == 1LL);
+    }
+
+    SECTION("double")
+    {
+        const double value_positive = 3.145926;
+        CHECK(round_n_decimal_places(value_positive, 0) == 3);
+        CHECK(round_n_decimal_places(value_positive, 1) == 3.1);
+        CHECK(round_n_decimal_places(value_positive, 2) == 3.15);
+        CHECK(round_n_decimal_places(value_positive, 3) == 3.146);
+        CHECK(round_n_decimal_places(value_positive, 4) == 3.1459);
+        CHECK(round_n_decimal_places(value_positive, 5) == 3.14593);
+        CHECK(round_n_decimal_places(value_positive, 6) == 3.145926);
+
+        const double value_negative = -3.145926;
+        CHECK(round_n_decimal_places(value_negative, 0) == -3);
+        CHECK(round_n_decimal_places(value_negative, 1) == -3.1);
+        CHECK(round_n_decimal_places(value_negative, 2) == -3.15);
+        CHECK(round_n_decimal_places(value_negative, 3) == -3.146);
+        CHECK(round_n_decimal_places(value_negative, 4) == -3.1459);
+        CHECK(round_n_decimal_places(value_negative, 5) == -3.14593);
+        CHECK(round_n_decimal_places(value_negative, 6) == -3.145926);
+    }
+
+    SECTION("Edge cases")
+    {
+        CHECK(round_n_decimal_places(1.005, 2) == 1.0);
+        CHECK(round_n_decimal_places(0.000001, 6) == 0.000001);
+        CHECK(round_n_decimal_places(0.0000001, 6) == 0);
+        CHECK(round_n_decimal_places(-0.000001, 6) == -0.000001);
+        CHECK(round_n_decimal_places(-0.0000001, 6) == 0);
+    }
+}