SYNC

firmware/common/utility.hpp

@@ -25,6 +25,7 @@
 #include <type_traits>
 #include <cstdint>
 #include <cstddef>
+#include <algorithm>
 #include <complex>
 #include <memory>
 
@@ -70,6 +71,37 @@ inline float magnitude_squared(const std::complex<float> c) {
 	return r2 + i2;
 }
 
+template<class T>
+struct range_t {
+	const T minimum;
+	const T maximum;
+
+	const T& clip(const T& value) const {
+		return std::max(std::min(value, maximum), minimum);
+	}
+
+	void reset_if_outside(T& value, const T& reset_value) const {
+		if( (value < minimum ) ||
+			(value > maximum ) ) {
+			value = reset_value;
+		}
+	}
+
+	bool below_range(const T& value) const {
+		return value < minimum;
+	}
+
+	bool contains(const T& value) const {
+		// TODO: Subtle gotcha here! Range test doesn't include maximum!
+		return (value >= minimum) && (value < maximum);
+	}
+
+	bool out_of_range(const T& value) const {
+		// TODO: Subtle gotcha here! Range test in contains() doesn't include maximum!
+		return !contains(value);
+	}
+};
+
 namespace std {
 
 /*! Stephan T Lavavej (STL!) implementation of make_unique, which has been accepted into the C++14 standard.