Fishery

2022-10-24 18:56:18 +02:00
parent 01ef055ff2
commit 9cdc8ccb4f
70 changed files with 19754 additions and 4 deletions
@@ -0,0 +1,47 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using System.Diagnostics.CodeAnalysis;
+
+namespace FisheryLib.Utility.Diagnostics;
+
+/// <inheritdoc/>
+public partial class Guard
+{
+	/// <inheritdoc/>
+	private partial class ThrowHelper
+	{
+		/// <summary>
+		/// Throws an <see cref="ArgumentException"/> when <see cref="IsNotEmpty{T}(Span{T},string)"/> fails.
+		/// </summary>
+		/// <typeparam name="T">The item of items in the input <see cref="Span{T}"/> instance.</typeparam>
+		/// <remarks>This method is needed because <see cref="Span{T}"/> can't be used as a generic type parameter.</remarks>
+		[DoesNotReturn]
+		public static void ThrowArgumentExceptionForIsNotEmptyWithSpan<T>(string name)
+		{
+			throw new ArgumentException($"Parameter {AssertString(name)} ({typeof(Span<T>).ToTypeString()}) must not be empty.", name);
+		}
+
+		/// <summary>
+		/// Throws an <see cref="ArgumentException"/> when <see cref="IsNotEmpty{T}(ReadOnlySpan{T},string)"/> fails.
+		/// </summary>
+		/// <typeparam name="T">The item of items in the input <see cref="ReadOnlySpan{T}"/> instance.</typeparam>
+		/// <remarks>This method is needed because <see cref="ReadOnlySpan{T}"/> can't be used as a generic type parameter.</remarks>
+		[DoesNotReturn]
+		public static void ThrowArgumentExceptionForIsNotEmptyWithReadOnlySpan<T>(string name)
+		{
+			throw new ArgumentException($"Parameter {AssertString(name)} ({typeof(ReadOnlySpan<T>).ToTypeString()}) must not be empty.", name);
+		}
+
+		/// <summary>
+		/// Throws an <see cref="ArgumentException"/> when <see cref="IsNotEmpty{T}(T[],string)"/> (or an overload) fails.
+		/// </summary>
+		/// <typeparam name="T">The item of items in the input collection.</typeparam>
+		[DoesNotReturn]
+		public static void ThrowArgumentExceptionForIsNotEmpty<T>(string name)
+		{
+			throw new ArgumentException($"Parameter {AssertString(name)} ({typeof(T).ToTypeString()}) must not be empty.", name);
+		}
+	}
+}