feat: 增加 HexConverter 类

Author: ArgoZhang

src/extensions/BootstrapBlazor.Socket/DataConverter/HexConverter.cs

@@ -0,0 +1,70 @@
+// Copyright (c) BootstrapBlazor & Argo Zhang (argo@live.ca). All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+// Website: https://www.blazor.zone or https://argozhang.github.io/
+
+using System.Text;
+
+namespace BootstrapBlazor.Components.DataConverter;
+
+/// <summary>
+/// Byte 数组扩展方法
+/// </summary>
+public static class HexConverter
+{
+    /// <summary>
+    /// 将 byte[] 转为 16 进制字符串
+    /// <para>Converts a byte array to its hexadecimal string representation.</para>
+    /// </summary>
+    /// <param name="bytes">The byte array to convert.</param>
+    /// <param name="separator"></param>
+    /// <returns>A string containing the hexadecimal representation of the byte array.</returns>
+    public static string ToString(byte[]? bytes, string? separator = "-")
+    {
+        if (bytes == null || bytes.Length == 0)
+        {
+            return string.Empty;
+        }
+
+        if (separator == "-")
+        {
+            return BitConverter.ToString(bytes);
+        }
+
+        var sb = new StringBuilder(bytes.Length * 3);
+        foreach (var b in bytes)
+        {
+            sb.Append(b.ToString("X2"));
+            sb.Append(separator);
+        }
+        return sb.ToString(0, sb.Length - 1);
+    }
+
+    /// <summary>
+    /// 将字符串转换为字节数组
+    /// </summary>
+    /// <param name="str"></param>
+    /// <param name="separator"></param>
+    /// <param name="options"></param>
+    /// <returns></returns>
+    public static byte[] ToByte(string str, string? separator = null, StringSplitOptions options = StringSplitOptions.None)
+    {
+        // 把 str 内的 delimiter 符号替换掉
+        if (!string.IsNullOrEmpty(separator))
+        {
+            str = string.Join("", str.Split(separator, options));
+        }
+
+        // 把 Hex 形式的 str 转化为 byte[]
+        if (str.Length % 2 != 0)
+        {
+            throw new ArgumentException("The raw string cannot have an odd number of digits. 参数 str 位数不正确无法转化为 16 进制字节数组", nameof(str));
+        }
+
+        var bytes = new byte[str.Length / 2];
+        for (var i = 0; i < bytes.Length; i++)
+        {
+            bytes[i] = Convert.ToByte(str.Substring(i * 2, 2), 16);
+        }
+        return bytes;
+    }
+}