/// <summary> /// Extension method that allows for <see cref="IntegralRangeBase{TIntegralType}.Constrain"/> /// to be called on a <see cref="UInt64"/> subject with the range and exclusivity passed as a /// parameter, rather than on the <see cref="IntegralRangeBase{TIntegralType}"/> object /// with a <see cref="UInt64"/> parameter. /// </summary> /// <param name="this"> /// The subject <see cref="UInt64"/> value in which to check against the <paramref name="range"/> /// parameter to constrain a value within a range with an implicit inclusive comparison mode. /// </param> /// <param name="range"> /// An instance of the type <see cref="UInt64Range"/>, describing a range of numeric values in /// which the <paramref name="this"/> subject is to be compared against. /// </param> /// <exception cref="ArgumentNullException"> /// Thrown when the specified <paramref name="range"/> is <see langword="null"/>. /// </exception> /// <returns> /// A <see cref="UInt64"/> value that is the <paramref name="this"/> subject value adjusted to /// force the range of possible values to be within the provided <paramref cref="range"/> /// parameter, using <see cref="EndpointExclusivity.Inclusive"/> as the comparison mode. /// </returns> public static UInt64 Constrain( this UInt64 @this, [NotNull] UInt64Range range) { range.IsNotNull(nameof(range)); return(range .Constrain( @this)); }
/// <summary> /// Extension method that allows for <see cref="IntegralRangeBase{TIntegralType}.IsNotWithin"/> /// to be called on a <see cref="UInt64"/> subject with the range and exclusivity passed as a /// parameter, rather than on the <see cref="IntegralRangeBase{TIntegralType}"/> object /// with a <see cref="UInt64"/> parameter. /// </summary> /// <param name="this"> /// The subject <see cref="UInt64"/> 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="UInt64Range"/>, 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="UInt64"/> 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 UInt64 @this, [NotNull] UInt64Range range, EndpointExclusivity exclusivity = EndpointExclusivity.Inclusive) { range.IsNotNull(nameof(range)); return(range .IsNotWithin( @this, exclusivity)); }
/// <summary> /// Extension method that performs a transformation on the <see cref="UInt64"/> subject using /// linear mapping to re-map from the provided initial range <paramref name="startRange"/> /// to the target range <paramref name="endRange"/>. /// </summary> /// <param name="this"> /// The subject <see cref="UInt64"/> to perform the linear map range re-mapping upon. /// </param> /// <param name="startRange"> /// An instance of the type <see cref="UInt64Range"/>, describing a range of numeric values in /// which the linear re-mapping uses as the inital range of the subject. /// </param> /// <param name="endRange"> /// An instance of the type <see cref="UInt64Range"/>, describing a range of numeric values in /// which the linear re-mapping uses as the target range of the return value. /// </param> /// <exception cref="ArgumentNullException"> /// Thrown when either the <paramref name="startRange"/> or the <paramref name="endRange"/> /// parameters are equal to <see langword="null"/>. /// </exception> /// <returns> /// A <see cref="UInt64"/> value that has been linearly mapped to the <paramref name="startRange"/> /// parameter and re-mapped to the <paramref name="endRange"/> parameter. /// </returns> public static UInt64 LinearMap( this UInt64 @this, [NotNull] UInt64Range startRange, [NotNull] UInt64Range endRange) { startRange.IsNotNull(nameof(startRange)); endRange.IsNotNull(nameof(endRange)); return(( (@this - startRange.Minimum) * (endRange.Maximum - endRange.Minimum) / (startRange.Maximum - startRange.Minimum) + endRange.Minimum) .To <UInt64>()); }