From de8a237f99494c2b0742b60d3efb51e0596cd5c0 Mon Sep 17 00:00:00 2001
From: Oliver Booth <me@olivr.me>
Date: Sun, 17 Jan 2021 12:50:23 +0000
Subject: [PATCH] =?UTF-8?q?=F0=9F=9A=9A=20Move=20ComparableExtensions=20to?=
 =?UTF-8?q?=20child=20namespace?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Item for #7 and #15
---
 X10D/src/ComparableExtensions.cs              | 27 ----------
 .../ComparableExtensions.cs                   | 54 +++++++++++++++++++
 2 files changed, 54 insertions(+), 27 deletions(-)
 delete mode 100644 X10D/src/ComparableExtensions.cs
 create mode 100644 X10D/src/ComparableExtensions/ComparableExtensions.cs

diff --git a/X10D/src/ComparableExtensions.cs b/X10D/src/ComparableExtensions.cs
deleted file mode 100644
index 3ff2ed1..0000000
--- a/X10D/src/ComparableExtensions.cs
+++ /dev/null
@@ -1,27 +0,0 @@
-using System;
-
-namespace X10D
-{
-    /// <summary>
-    ///     Extension methods for <see cref="IComparable" />.
-    /// </summary>
-    public static class ComparableExtensions
-    {
-        /// <summary>
-        ///     Determines if <paramref name="actual" /> is between <paramref name="lower" /> and <paramref name="upper" />.
-        /// </summary>
-        /// <typeparam name="T">The comparable type.</typeparam>
-        /// <param name="actual">The value to compare.</param>
-        /// <param name="lower">The exclusive lower bound.</param>
-        /// <param name="upper">The exclusive upper bound.</param>
-        /// <returns>
-        ///     Returns <see langword="true" /> if the value is between the bounds, <see langword="false" />
-        ///     otherwise.
-        /// </returns>
-        public static bool Between<T>(this T actual, T lower, T upper)
-            where T : IComparable<T>
-        {
-            return actual.CompareTo(lower) > 0 && actual.CompareTo(upper) < 0;
-        }
-    }
-}
diff --git a/X10D/src/ComparableExtensions/ComparableExtensions.cs b/X10D/src/ComparableExtensions/ComparableExtensions.cs
new file mode 100644
index 0000000..d357e9d
--- /dev/null
+++ b/X10D/src/ComparableExtensions/ComparableExtensions.cs
@@ -0,0 +1,54 @@
+using System;
+using System.Runtime.CompilerServices;
+
+namespace X10D.ComparableExtensions
+{
+    /// <summary>
+    ///     Extension methods for <see cref="IComparable{T}" />.
+    /// </summary>
+    public static partial class ComparableExtensions
+    {
+        /// <summary>
+        ///     Determines if <paramref name="actual" /> is between <paramref name="lower" /> and <paramref name="upper" />.
+        /// </summary>
+        /// <typeparam name="T1">An <see cref="IComparable{T2}" /> type.</typeparam>
+        /// <typeparam name="T2">The first comparison operand type.</typeparam>
+        /// <typeparam name="T3">The second comparison operand type.</typeparam>
+        /// <param name="actual">The value to compare.</param>
+        /// <param name="lower">The exclusive lower bound.</param>
+        /// <param name="upper">The exclusive upper bound.</param>
+        /// <returns>
+        ///     <see langword="true" /> if <paramref name="actual" /> is between the <paramref name="lower"/> and
+        ///     <paramref name="upper"/>
+        ///     -or-
+        ///     <see langword="false" /> otherwise.
+        /// </returns>
+        /// <example>
+        /// <code lang="csharp">
+        /// int firstValue = 42;
+        /// int secondValue = 15;
+        /// 
+        /// int lower = 0;
+        /// int upper = 20;
+        ///
+        /// Console.WriteLine($"{firstValue} between {lower} and {upper}?");
+        /// Console.WriteLine(firstValue.Between(lower, upper));
+        /// 
+        /// Console.WriteLine($"{secondValue} between {lower} and {upper}?");
+        /// Console.WriteLine(secondValue.Between(lower, upper));
+        ///
+        /// // This will output the following:
+        /// //      42 between 0 and 20?
+        /// //      False
+        /// //      15 between 0 and 20?
+        /// //      True
+        /// </code>
+        /// </example>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static bool Between<T1, T2, T3>(this T1 actual, T2 lower, T3 upper)
+            where T1 : IComparable<T2>, IComparable<T3>
+        {
+            return actual.CompareTo(lower) > 0 && actual.CompareTo(upper) < 0;
+        }
+    }
+}