using System; using System.Diagnostics.CodeAnalysis; namespace MediaBrowser.Common { /// /// Encoding and decoding hex strings. /// public static class Hex { internal const string HexCharsLower = "0123456789abcdef"; internal const string HexCharsUpper = "0123456789ABCDEF"; internal const int LastHexSymbol = 0x66; // 102: f /// /// Gets a map from an ASCII char to its hex value shifted, /// e.g. b -> 11. 0xFF means it's not a hex symbol. /// internal static ReadOnlySpan HexLookup => new byte[] { 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x0A, 0x0B, 0x0C, 0x0D, 0x0E, 0x0F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x0a, 0x0b, 0x0c, 0x0d, 0x0e, 0x0f }; /// /// Encodes each element of the specified bytes as its hexadecimal string representation. /// /// An array of bytes. /// true to use lowercase hexadecimal characters; otherwise false. /// bytes as a hex string. public static string Encode(ReadOnlySpan bytes, bool lowercase = true) { var hexChars = lowercase ? HexCharsLower : HexCharsUpper; // TODO: use string.Create when it's supports spans // Ref: https://github.com/dotnet/corefx/issues/29120 char[] s = new char[bytes.Length * 2]; int j = 0; for (int i = 0; i < bytes.Length; i++) { s[j++] = hexChars[bytes[i] >> 4]; s[j++] = hexChars[bytes[i] & 0x0f]; } return new string(s); } /// /// Decodes a hex string into bytes. /// /// The . /// The decoded bytes. public static byte[] Decode(ReadOnlySpan str) { if (str.Length == 0) { return Array.Empty(); } var unHex = HexLookup; int byteLen = str.Length / 2; byte[] bytes = new byte[byteLen]; int i = 0; for (int j = 0; j < byteLen; j++) { byte a; byte b; if (str[i] > LastHexSymbol || (a = unHex[str[i++]]) == 0xFF || str[i] > LastHexSymbol || (b = unHex[str[i++]]) == 0xFF) { ThrowArgumentException(nameof(str)); break; // Unreachable } bytes[j] = (byte)((a * 16) | b); } return bytes; } [DoesNotReturn] private static void ThrowArgumentException(string paramName) => throw new ArgumentException("Character is not a hex symbol.", paramName); } }