/// <summary>
/// Extension method that allows for <see cref="IntegralRangeBase{TIntegralType}.IsNotWithin"/>
/// to be called on a <see cref="Byte"/> subject with the range and exclusivity passed as a
/// parameter, rather than on the <see cref="IntegralRangeBase{TIntegralType}"/> object
/// with a <see cref="Byte"/> parameter.
/// </summary>
/// <param name="this">
/// The subject <see cref="Byte"/> value in which to check against the <paramref name="range"/>
/// parameter to determine whether it is within the range, taking into account the exclusivity.
/// </param>
/// <param name="range">
/// An instance of the type <see cref="ByteRange"/>, describing a range of numeric values in
/// which the <paramref name="this"/> subject is to be compared against.
/// </param>
/// <param name="exclusivity">
/// A value indicating whether to perform the upper and lower bounds comparisons including
/// the range's Minimum and Maximum bounds, or to exclude them. This parameter is optional,
/// and the default value is <see cref="EndpointExclusivity.Inclusive"/>.
/// </param>
/// <exception cref="ArgumentNullException">
/// Thrown when the specified <paramref name="range"/> is <see langword="null"/>.
/// </exception>
/// <returns>
/// A <see cref="Byte"/> value indicating whether or not the <paramref name="this"/> subject
/// is within the provided <paramref cref="range"/> parameter, taking into account the
/// <see cref="EndpointExclusivity"/> mode via the <paramref name="exclusivity"/> parameter.
/// This comparison is the logical inverse of the <see cref="IsNotWithin"/> extension method.
/// </returns>
public static bool IsNotWithin(
this Byte @this,
[NotNull] ByteRange range,
EndpointExclusivity exclusivity = EndpointExclusivity.Inclusive)
{
range.IsNotNull(nameof(range));
return(range
.IsNotWithin(
@this,
exclusivity));
}
public static void ThrowIfNotWithin(
[AssertionCondition(IS_NOT_NULL)] this Byte @this,
[NotNull] ByteRange range,
[InvokerParameterName] string elementName,
EndpointExclusivity exclusivity = Inclusive,
[CallerMemberName] string callerMemberName = "")
{
range.IsNotNull(nameof(range));
if (range
.IsNotWithin(
@this,
exclusivity))
{
throw new ArgumentOutOfRangeException(
elementName,
$"Parameter {elementName.SQuote()} passed to the method {callerMemberName.SQuote()} " +
$"must be within [{range.Minimum} and {range.Maximum}], {exclusivity}ly.");
}
}