HexConverter.cs

// 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/

namespace BootstrapBlazor.Socket.DataConverters;

/// <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>
    /// <param name="upper"></param>
    /// <returns>A string containing the hexadecimal representation of the byte array.</returns>
    public static string ToString(byte[]? bytes, string? separator = "-", bool upper = true)
    {
        if (bytes == null || bytes.Length == 0)
        {
            return string.Empty;
        }

        if (separator == "-")
        {
            return BitConverter.ToString(bytes);
        }

        return string.Join(separator, bytes.Select(i => upper ? i.ToString("X2") : i.ToString("x2")));
    }

    /// <summary>
    /// 将 byte[] 转为 16 进制字符串
    /// <para>Converts a byte array to its hexadecimal string representation.</para>
    /// </summary>
    /// <param name="span"></param>
    /// <param name="separator"></param>
    /// <param name="upper"></param>
    /// <returns></returns>
    public static string ToString(ReadOnlySpan<byte> span, string? separator = "-", bool upper = true) => ToString(span.ToArray(), separator, upper);

    /// <summary>
    /// 将字符串转换为字节数组
    /// </summary>
    /// <param name="str"></param>
    /// <param name="separator"></param>
    /// <param name="options"></param>
    /// <returns></returns>
    public static byte[] ToBytes(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;
    }
}