Add a ToDataSize extension

Author: Coding-Enthusiast

Src/Autarkysoft.Bitcoin/ExtentionsAndHelpers.cs

@@ -458,6 +458,33 @@ public static string ToOrdinal(this int i)
         /// <param name="i">The 32-bit unsigned integer to reverse</param>
         /// <returns>The 32-bit signed uninteger result with reverse endianness</returns>
         public static uint SwapEndian(this uint i) => (i >> 24) | (i << 24) | ((i >> 8) & 0xff00) | ((i << 8) & 0xff0000);
+
+        /// <summary>
+        /// Converts the given 64-bit signed integer to binary data size (byte, kilo-byte, mega-byte, etc.)
+        /// </summary>
+        /// <param name="val">64-bit signed integer</param>
+        /// <returns>Data size</returns>
+        public static string ToDataSize(this long val)
+        {
+            if (val < 0)
+            {
+                return "Invalid (negative) size.";
+            }
+
+            decimal size = val;
+            int index = 0;
+            while (size >= 1000 && index < SizeSuffix.Length - 1)
+            {
+                index++;
+                size /= 1024;
+            }
+
+            return $"{(index == 0 ? $"{size:n0}" : (size < 10 ? $"{size:n2}" : (size < 100 ? $"{size:n1}" : $"{size:n0}")))}" +
+                   $" {SizeSuffix[index]}";
+        }
+
+        // exabyte is 10^18 and same size as long.MaxValue
+        private static readonly string[] SizeSuffix = { "B", "KB", "MB", "GB", "TB", "PB", "EB" };
     }
 
 

Src/Tests/Bitcoin/ExtentionsAndHelpersTests/IntegerExtensionTests.cs

@@ -69,5 +69,27 @@ public void SwapEndian_UIntTest(uint val, uint expected)
         {
             Assert.Equal(expected, val.SwapEndian());
         }
+
+        [Theory]
+        [InlineData(-1, "Invalid (negative) size.")]
+        [InlineData(0, "0 B")]
+        [InlineData(1, "1 B")]
+        [InlineData(999, "999 B")]
+        [InlineData(1000, "0.98 KB")] // 0.9765 rounded up with 2 decimal places
+        [InlineData(1024, "1.00 KB")] // 1.0000 with 2 decimal places
+        [InlineData(1030, "1.01 KB")] // 1.0058 rounded up
+        [InlineData(10240, "10.0 KB")] // 1 decimal place
+        [InlineData(102400, "100 KB")] // 0 decimal place
+        [InlineData(153600, "150 KB")] // 0 decimal place
+        [InlineData(1032192, "0.98 MB")] // 0.984375
+        [InlineData(1024L * 1024, "1.00 MB")]
+        [InlineData(1024L * 1024 * 1024, "1.00 GB")]
+        [InlineData(1024L * 1024 * 1024 * 1024, "1.00 TB")]
+        [InlineData(1024L * 1024 * 1024 * 1024 * 1024, "1.00 PB")]
+        [InlineData(1024L * 1024 * 1024 * 1024 * 1024 * 1024, "1.00 EB")]
+        public void ToDataSizeTest(long val, string expected)
+        {
+            Assert.Equal(expected, val.ToDataSize());
+        }
     }
 }