DefinedEnum.ThrowUndefinedInput() now has return type, to facilitate use in expressions.

Author: Timovzl

DomainModeling/Enums/DefinedEnum.cs

@@ -1,3 +1,4 @@
+using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using Architect.DomainModeling.Enums;
 
@@ -29,13 +30,14 @@ public static class DefinedEnum
 	/// </summary>
 	/// <param name="enumType">The enum's type.</param>
 	/// <param name="numericValue">The enum's numeric value, such as (Int128)(int)HttpStatusCode.OK.</param>
-	/// <param name="errorState">An optional error state to be passed to <see cref="ExceptionFactoryForUndefinedInput"/>.</param>
+	/// <param name="errorState">An optional error state to be passed to <see cref="ExceptionFactoryForUndefinedInput"/>.</param>
+	/// <returns>Pretends to return an <see cref="Exception"/>, to facilitate use in expressions (e.g. switch expression), where a result or a throw is required.</returns>
 	[DoesNotReturn]
-	public static void ThrowUndefinedInput(Type enumType, Int128 numericValue, string? errorState = null)
+	public static Exception ThrowUndefinedInput(Type enumType, Int128 numericValue, string? errorState = null)
 	{
 		throw ExceptionFactoryForUndefinedInput?.Invoke(enumType, numericValue, errorState) ?? new ArgumentException($"Only recognized {enumType.Name} values are permitted.");
-	}
-
+	}
+
 	/// <summary>
 	/// <para>
 	/// Throws the configured exception for enum value <paramref name="value"/> being undefined for its type.
@@ -45,12 +47,13 @@ public static void ThrowUndefinedInput(Type enumType, Int128 numericValue, strin
 	/// </para>
 	/// </summary>
 	/// <param name="value">The enum's value.</param>
-	/// <param name="errorState">An optional error state to be passed to <see cref="ExceptionFactoryForUndefinedInput"/>.</param>
+	/// <param name="errorState">An optional error state to be passed to <see cref="ExceptionFactoryForUndefinedInput"/>.</param>
+	/// <returns>Pretends to return <typeparamref name="TEnum"/>, to facilitate use in expressions (e.g. switch expression), where a result or a throw is required.</returns>
 	[DoesNotReturn]
-	public static void ThrowUndefinedInput<TEnum>(TEnum value, string? errorState = null)
+	public static TEnum ThrowUndefinedInput<TEnum>(TEnum value, string? errorState = null)
 		where TEnum : unmanaged, Enum
 	{
-		ThrowUndefinedInput(typeof(TEnum), value.GetNumericValue(), errorState);
+		throw ThrowUndefinedInput(typeof(TEnum), value.GetNumericValue(), errorState);
 	}
 
 	/// <summary>