From a401aabee8fd74d1a66b86b6258ea3400a298fe8 Mon Sep 17 00:00:00 2001
From: Oliver Booth <me@olivr.me>
Date: Sun, 7 Mar 2021 14:20:01 +0000
Subject: [PATCH] Add Random.Next<T>() where T : Enum

---
 X10D/src/RandomExtensions/RandomExtensions.cs | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/X10D/src/RandomExtensions/RandomExtensions.cs b/X10D/src/RandomExtensions/RandomExtensions.cs
index f9a8bc2..4da372c 100644
--- a/X10D/src/RandomExtensions/RandomExtensions.cs
+++ b/X10D/src/RandomExtensions/RandomExtensions.cs
@@ -11,6 +11,27 @@ namespace X10D.RandomExtensions
     {
         internal static readonly Random Random = new();
 
+        /// <summary>
+        ///     Returns a random value that defined in a specified enum.
+        /// </summary>
+        /// <param name="random">The <see cref="System.Random" /> instance.</param>
+        /// <typeparam name="T">An enum type.</typeparam>
+        /// <returns>
+        ///     A <typeparamref name="T" /> value at index <c>n</c> where <c>n = </c><see cref="System.Random.Next(int)" />.
+        /// </returns>
+        /// <exception cref="ArgumentNullException"><paramref name="random" /> is <see langword="null" />.</exception>
+        public static T Next<T>(this Random random)
+            where T : struct, Enum
+        {
+            if (random is null)
+            {
+                throw new ArgumentNullException(nameof(random));
+            }
+
+            var values = Enum.GetValues(typeof(T));
+            return (T)values.GetValue(random.Next(values.Length))!;
+        }
+
         /// <summary>
         ///     Returns either <see langword="true" /> or <see langword="false" /> based on the next generation of the current
         ///     <see cref="System.Random" />.