feat: 为Number添加更多处理方式

server/src/Common/Number.cs

@@ -78,6 +78,56 @@ public class Number
         return arr;
     }
 
+    /// <summary>
+    /// 二进制字节数组转成64bits整数
+    /// </summary>
+    /// <param name="bytes">二进制字节数组</param>
+    /// <param name="offset">字节数组偏移量</param>
+    /// <param name="numLength">字节数组长度</param>
+    /// <param name="isLowNumHigh">是否高位在数组索引低</param>
+    /// <returns>整数</returns>
+    public static Result<UInt64> BytesToUInt64(byte[] bytes, int offset = 0, int numLength = 8, bool isLowNumHigh = false)
+    {
+        if (bytes.Length < offset)
+        {
+            return new(new ArgumentException($"The Length of bytes is less than offset"));
+        }
+
+        if (numLength > 8)
+        {
+            return new(new ArgumentException($"The Length of bytes is greater than 8"));
+        }
+
+        if (numLength <= 0) return 0;
+
+        try
+        {
+            byte[] numBytes = new byte[8]; // 8字节
+            int copyLen = Math.Min(numLength, bytes.Length - offset);
+
+            if (isLowNumHigh)
+            {
+                // 小端：拷贝到低位
+                Buffer.BlockCopy(bytes, offset, numBytes, 0, copyLen);
+            }
+            else
+            {
+                // 大端：拷贝到高位
+                byte[] temp = new byte[copyLen];
+                Buffer.BlockCopy(bytes, offset, temp, 0, copyLen);
+                Array.Reverse(temp);
+                Buffer.BlockCopy(temp, 0, numBytes, 8 - copyLen, copyLen);
+            }
+
+            UInt64 num = BitConverter.ToUInt64(numBytes, 0);
+            return num;
+        }
+        catch (Exception error)
+        {
+            return new(error);
+        }
+    }
+
     /// <summary>
     /// 二进制字节数组转成64bits整数
     /// </summary>
@@ -86,25 +136,78 @@ public class Number
     /// <returns>整数</returns>
     public static Result<UInt64> BytesToUInt64(byte[] bytes, bool isLowNumHigh = false)
     {
-        if (bytes.Length > 8)
+        return BytesToUInt64(bytes, 0, 8, isLowNumHigh);
+    }
+
+    /// <summary>
+    /// 二进制字节数组转成64bits整数
+    /// </summary>
+    /// <param name="bytes">二进制字节数组</param>
+    /// <returns>整数</returns>
+    public static Result<UInt64> BytesToUInt64(byte[] bytes)
+    {
+        return BytesToUInt64(bytes, 0, 8, false);
+    }
+
+    /// <summary>
+    /// 二进制字节数组转成32bits整数
+    /// </summary>
+    /// <param name="bytes">二进制字节数组</param>
+    /// <param name="offset">字节数组偏移量</param>
+    /// <param name="numLength">整形所占字节数组长度</param>
+    /// <param name="isLowNumHigh">是否高位在数组索引低</param>
+    /// <returns>整数</returns>
+    public static Result<UInt32> BytesToUInt32(byte[] bytes, int offset = 0, int numLength = 4, bool isLowNumHigh = false)
+    {
+        if (bytes.Length < offset)
         {
-            return new(new ArgumentException(
-                "Unsigned long number can't over 8 bytes(64 bits).",
-                nameof(bytes)
-            ));
+            return new(new ArgumentException($"The Length of bytes is less than offset"));
         }
 
-        UInt64 num = 0;
-        int len = bytes.Length;
+        if (numLength > 4)
+        {
+            return new(new ArgumentException($"The Length of bytes is greater than 4"));
+        }
+
+        if (bytes.Length < offset)
+        {
+            return new(new ArgumentException($"The Length of bytes is less than offset"));
+        }
+
+        if (numLength > 4)
+        {
+            return new(new ArgumentException($"The Length of bytes is greater than 4"));
+        }
+
+        if (numLength <= 0) return 0;
 
         try
         {
-            if (!isLowNumHigh)
-            {
-                Array.Reverse(bytes);
-            }
-            num = BitConverter.ToUInt64(bytes, 0);
+            byte[] numBytes = new byte[4]; // 4字节
+            int copyLen = Math.Min(numLength, bytes.Length - offset);
+            if (copyLen < 0) copyLen = 0;
 
+            if (isLowNumHigh)
+            {
+                // 小端：拷贝到低位
+                if (copyLen > 0)
+                {
+                    Buffer.BlockCopy(bytes, offset, numBytes, 0, copyLen);
+                }
+            }
+            else
+            {
+                // 大端：拷贝到高位
+                if (copyLen > 0)
+                {
+                    byte[] temp = new byte[copyLen];
+                    Buffer.BlockCopy(bytes, offset, temp, 0, copyLen);
+                    Array.Reverse(temp);
+                    Buffer.BlockCopy(temp, 0, numBytes, 4 - copyLen, copyLen);
+                }
+            }
+
+            UInt32 num = BitConverter.ToUInt32(numBytes, 0);
             return num;
         }
         catch (Exception error)
@@ -121,32 +224,17 @@ public class Number
     /// <returns>整数</returns>
     public static Result<UInt32> BytesToUInt32(byte[] bytes, bool isLowNumHigh = false)
     {
-        if (bytes.Length > 4)
-        {
-            return new(new ArgumentException(
-                "Unsigned long number can't over 4 bytes(32 bits).",
-                nameof(bytes)
-            ));
-        }
-
-        UInt32 num = 0;
-        int len = bytes.Length;
-
-        try
-        {
-            if (!isLowNumHigh)
-            {
-                Array.Reverse(bytes);
-            }
-            num = BitConverter.ToUInt32(bytes, 0);
-
-            return num;
-        }
-        catch (Exception error)
-        {
-            return new(error);
-        }
+        return BytesToUInt32(bytes, 0, 4, isLowNumHigh);
+    }
 
+    /// <summary>
+    /// 二进制字节数组转成32bits整数
+    /// </summary>
+    /// <param name="bytes">二进制字节数组</param>
+    /// <returns>整数</returns>
+    public static Result<UInt32> BytesToUInt32(byte[] bytes)
+    {
+        return BytesToUInt32(bytes, 0, 4, false);
     }
 
     /// <summary>