添加浮点数五舍六入方法；添加区间的 Clamp 方法

DotNetCampus.Numerics/FloatingPointHelper.cs

@@ -66,5 +66,24 @@ public static TNum Sqrt<TNum>(this TNum a)
         throw new NotSupportedException();
     }
 
+    public static TNum Clamp<TNum>(this TNum value, TNum min, TNum max)
+        where TNum : unmanaged, IFloatingPoint<TNum>
+    {
+        if (typeof(TNum) == typeof(float))
+            return Unsafe.BitCast<float, TNum>(Math.Clamp(Unsafe.BitCast<TNum, float>(value), Unsafe.BitCast<TNum, float>(min), Unsafe.BitCast<TNum, float>(max)));
+
+        if (typeof(TNum) == typeof(double))
+            return Unsafe.BitCast<double, TNum>(Math.Clamp(Unsafe.BitCast<TNum, double>(value), Unsafe.BitCast<TNum, double>(min), Unsafe.BitCast<TNum, double>(max)));
+
+        if (typeof(TNum) == typeof(NFloat))
+            return Unsafe.BitCast<NFloat, TNum>(NFloat.Clamp(Unsafe.BitCast<TNum, NFloat>(value), Unsafe.BitCast<TNum, NFloat>(min), Unsafe.BitCast<TNum, NFloat>(max)));
+
+        return value <= min
+            ? min
+            : value >= max
+                ? max
+                : value;
+    }
+
     #endregion
 }

DotNetCampus.Numerics/FloatingPointNumberExtensions.cs

@@ -1,3 +1,5 @@
+using System.Runtime.Intrinsics.Arm;
+
 namespace DotNetCampus.Numerics;
 
 /// <summary>
@@ -84,6 +86,7 @@ public static int Round(this float value)
     /// <returns>四舍五入到整数。</returns>
     public static int RoundingHalfAwayFromZero(this double value)
     {
+
         return (int)Math.Round(value, MidpointRounding.AwayFromZero);
     }
 
@@ -97,6 +100,26 @@ public static int RoundingHalfAwayFromZero(this float value)
         return (int)MathF.Round(value, MidpointRounding.AwayFromZero);
     }
 
+    /// <summary>
+    /// 对浮点数进行五舍六入。
+    /// </summary>
+    /// <param name="value">要进行五舍六入的浮点数。</param>
+    /// <returns>五舍六入到整数。</returns>
+    public static int RoundingHalfToZero(this double value)
+    {
+        return (int)Math.Truncate(value - Math.CopySign(0.5, value));
+    }
+
+    /// <summary>
+    /// 对浮点数进行五舍六入。
+    /// </summary>
+    /// <param name="value">要进行五舍六入的浮点数。</param>
+    /// <returns>五舍六入到整数。</returns>
+    public static int RoundingHalfToZero(this float value)
+    {
+        return (int)MathF.Truncate(value - MathF.CopySign(0.5f, value));
+    }
+
     /// <summary>
     /// 对浮点数进行向下取整。
     /// </summary>
@@ -281,4 +304,4 @@ public static double Pow(this float value, double exponent)
     }
 
     #endregion
-}
+}

DotNetCampus.Numerics/Interval.cs

@@ -67,6 +67,16 @@ public bool Contains(TNum value)
         return Start <= value && value <= End;
     }
 
+    /// <summary>
+    /// 将目标值限制在区间内。
+    /// </summary>
+    /// <param name="value">需要限制的值。</param>
+    /// <returns>限制后的值。</returns>
+    public TNum Clamp(ref TNum value)
+    {
+        return value.Clamp(Start, End);
+    }
+
     /// <inheritdoc />
     public override string ToString()
     {