Added arrays for specificity.

Author: Oren (electricessence)

Open.RandomizationExtensions.csproj

@@ -14,7 +14,7 @@ Part of the "Open" set of libraries.</Description>
     <RepositoryUrl>https://github.com/electricessence/Open.RandomizationExtensions</RepositoryUrl>
     <RepositoryType>Git</RepositoryType>
     <PackageTags>random select</PackageTags>
-    <Version>1.1.0</Version>
+    <Version>1.1.1</Version>
   </PropertyGroup>
 
   <ItemGroup>

Random.cs

@@ -233,6 +233,17 @@ public static int RandomSelectIndex<T>(this IReadOnlyCollection<T> source, IEnum
 		public static int RandomSelectIndex<T>(this ICollection<T> source, IEnumerable<T> exclusion = null)
 			=> RandomSelectIndex(source.Count, source, exclusion);
 
+		/// <summary>
+		/// Randomly selects an index from the source.
+		/// Will not return indexes that are contained in the optional exclusion set.
+		/// </summary>
+		/// <typeparam name="T">The generic type of the source.</typeparam>
+		/// <param name="source">The source array.</param>
+		/// <param name="exclusion">The optional values to exclude from selection.</param>
+		/// <returns>The index selected.</returns>
+		public static int RandomSelectIndex<T>(this T[] source, IEnumerable<T> exclusion = null)
+			=> RandomSelectIndex(source.Length, source, exclusion);
+
 		/// <summary>
 		/// Randomly selects an index from the source.
 		/// Will not return indexes that are contained in the optional exclusion set.
@@ -343,6 +354,18 @@ public static int RandomSelectIndexExcept<T>(this IReadOnlyCollection<T> source,
 		public static int RandomSelectIndexExcept<T>(this ICollection<T> source, T exclusion, params T[] others)
 			=> RandomSelectIndexExcept(source.Count, source, exclusion, others);
 
+		/// <summary>
+		/// Randomly selects an index from the source.
+		/// Will not return indexes that are contained in the optional exclusion set.
+		/// </summary>
+		/// <typeparam name="T">The generic type of the source.</typeparam>
+		/// <param name="source">The source array.</param>
+		/// <param name="exclusion">A value to exclude from selection.</param>
+		/// <param name="others">The additional set of optional values to exclude from selection.</param>
+		/// <returns>The index selected.</returns>
+		public static int RandomSelectIndexExcept<T>(this T[] source, T exclusion, params T[] others)
+			=> RandomSelectIndexExcept(source.Length, source, exclusion, others);
+
 		/// <summary>
 		/// Attempts to select an index at random from the source and returns the value from it..
 		/// Will not select indexes that are contained in the optional exclusion set.
@@ -388,7 +411,7 @@ public static bool TryRandomSelectOne<T>(
 		/// Will not select indexes that are contained in the optional exclusion set.
 		/// </summary>
 		/// <typeparam name="T">The generic type of the source.</typeparam>
-		/// <param name="source">The source span.</param>
+		/// <param name="source">The source collection.</param>
 		/// <param name="exclusion">The optional values to exclude from selection.</param>
 		/// <returns>The value selected.</returns>
 		public static T RandomSelectOne<T>(
@@ -412,7 +435,7 @@ public static T RandomSelectOne<T>(
 		/// Will not select indexes that are contained in the optional exclusion set.
 		/// </summary>
 		/// <typeparam name="T">The generic type of the source.</typeparam>
-		/// <param name="source">The source span.</param>
+		/// <param name="source">The source collection.</param>
 		/// <param name="exclusion">The optional values to exclude from selection.</param>
 		/// <returns>The value selected.</returns>
 		public static T RandomSelectOne<T>(
@@ -431,6 +454,28 @@ public static T RandomSelectOne<T>(
 				: source.ElementAt(index);
 		}
 
+		/// <summary>
+		/// Selects an index at random from the source and returns the value from it.
+		/// Will not select indexes that are contained in the optional exclusion set.
+		/// </summary>
+		/// <typeparam name="T">The generic type of the source.</typeparam>
+		/// <param name="source">The source array.</param>
+		/// <param name="exclusion">The optional values to exclude from selection.</param>
+		/// <returns>The value selected.</returns>
+		public static T RandomSelectOne<T>(
+			this T[] source,
+			IEnumerable<T> exclusion = null)
+		{
+			if (source.Length == 0)
+				throw new InvalidOperationException("Source collection is empty.");
+
+			var index = RandomSelectIndex(source, exclusion);
+			if (index == -1)
+				throw new InvalidOperationException("Exclusion set invalidates the source.  No possible value can be selected.");
+
+			return source[index];
+		}
+
 		/// <summary>
 		/// Attempts to select an index at random from the source and returns the value from it..
 		/// Will not select indexes that are contained in the optional exclusion set.
@@ -487,6 +532,32 @@ public static bool TryRandomSelectOne<T>(
 			return true;
 		}
 
+		/// <summary>
+		/// Attempts to select an index at random from the source and returns the value from it..
+		/// Will not select indexes that are contained in the optional exclusion set.
+		/// </summary>
+		/// <typeparam name="T">The generic type of the source.</typeparam>
+		/// <param name="source">The source array.</param>
+		/// <param name="value">The value selected.</param>
+		/// <param name="exclusion">The optional values to exclude from selection.</param>
+		/// <returns>True if a valid value was selected.</returns>
+		public static bool TryRandomSelectOne<T>(
+			this T[] source,
+			out T value,
+			IEnumerable<T> exclusion = null)
+		{
+			var index = RandomSelectIndex(source, exclusion);
+			if (index == -1)
+			{
+				value = default;
+				return false;
+			}
+
+			value = source[index];
+
+			return true;
+		}
+
 		/// <summary>
 		/// Attempts to select an index at random from the source and returns the value from it..
 		/// Will not select indexes that are contained in the optional exclusion set.
@@ -587,6 +658,33 @@ public static bool TryRandomSelectOneExcept<T>(
 			return true;
 		}
 
+		/// <summary>
+		/// Attempts to select an index at random from the source and returns the value from it..
+		/// Will not select indexes that are contained in the optional exclusion set.
+		/// </summary>
+		/// <typeparam name="T">The generic type of the source.</typeparam>
+		/// <param name="source">The source array.</param>
+		/// <param name="value">The value selected.</param>
+		/// <param name="excluding">The value to exclude from selection.</param>
+		/// <param name="others">The additional set of optional values to exclude from selection.</param>
+		/// <returns>True if a valid value was selected.</returns>
+		public static bool TryRandomSelectOneExcept<T>(
+			this T[] source,
+			out T value,
+			T excluding, params T[] others)
+		{
+			var index = RandomSelectIndexExcept(source, excluding, others);
+			if (index == -1)
+			{
+				value = default;
+				return false;
+			}
+
+			value = source[index];
+
+			return true;
+		}
+
 		/// <summary>
 		/// Selects an index at random from the source and returns the value from it.
 		/// Will not select indexes that are contained in the optional exclusion set.
@@ -667,6 +765,28 @@ public static T RandomSelectOneExcept<T>(
 			throw new InvalidOperationException("Exclusion set invalidates the source.  No possible value can be selected.");
 		}
 
+		/// <summary>
+		/// Selects an index at random from the source and returns the value from it.
+		/// Will not select indexes that are contained in the optional exclusion set.
+		/// </summary>
+		/// <typeparam name="T">The generic type of the source.</typeparam>
+		/// <param name="source">The source array.</param>
+		/// <param name="excluding">The value to exclude from selection.</param>
+		/// <param name="others">The additional set of optional values to exclude from selection.</param>
+		/// <returns>The value selected.</returns>
+		public static T RandomSelectOneExcept<T>(
+			this T[] source,
+			T excluding, params T[] others)
+		{
+			if (source.Length == 0)
+				throw new InvalidOperationException("Source array is empty.");
+
+			if (source.TryRandomSelectOneExcept(out T value, excluding, others))
+				return value;
+
+			throw new InvalidOperationException("Exclusion set invalidates the source.  No possible value can be selected.");
+		}
+
 		/// <summary>
 		/// Select a random number except the excluded ones.
 		/// </summary>