// /*************************************************************************** // The Disc Image Chef // ---------------------------------------------------------------------------- // // Filename : BigEndianBitConverter.cs // Author(s) : Natalia Portillo // // Component : Helpers. // // --[ Description ] ---------------------------------------------------------- // // Override of System.BitConverter that knows how to handle big-endian. // // --[ License ] -------------------------------------------------------------- // // This library is free software; you can redistribute it and/or modify // it under the terms of the GNU Lesser General Public License as // published by the Free Software Foundation; either version 2.1 of the // License, or (at your option) any later version. // // This library is distributed in the hope that it will be useful, but // WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU // Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public // License along with this library; if not, see . // // ---------------------------------------------------------------------------- // Copyright © 2011-2018 Natalia Portillo // ****************************************************************************/ using System; using System.Linq; namespace DiscImageChef { /// /// Converts base data types to an array of bytes, and an array of bytes to base /// data types. /// All info taken from the meta data of System.BitConverter. This implementation /// allows for Endianness consideration. /// public static class BigEndianBitConverter { /// /// Indicates the byte order ("endianess") in which data is stored in this computer /// architecture. /// public static bool IsLittleEndian { get; set; } /// /// Converts the specified double-precision floating point number to a 64-bit signed integer. /// /// The number to convert. /// A 64-bit signed integer whose value is equivalent to value. /// It is not currently implemented public static long DoubleToInt64Bits(double value) { throw new NotImplementedException(); } /// /// Returns the specified Boolean value as an array of bytes. /// /// A Boolean value. /// An array of bytes with length 1. public static byte[] GetBytes(bool value) { return !IsLittleEndian ? BitConverter.GetBytes(value) : BitConverter.GetBytes(value).Reverse().ToArray(); } /// /// Returns the specified Unicode character value as an array of bytes. /// /// A character to convert. /// An array of bytes with length 2. public static byte[] GetBytes(char value) { return !IsLittleEndian ? BitConverter.GetBytes(value) : BitConverter.GetBytes(value).Reverse().ToArray(); } /// /// Returns the specified double-precision floating point value as an array of bytes. /// /// The number to convert. /// An array of bytes with length 8. public static byte[] GetBytes(double value) { return !IsLittleEndian ? BitConverter.GetBytes(value) : BitConverter.GetBytes(value).Reverse().ToArray(); } /// /// Returns the specified single-precision floating point value as an array of bytes. /// /// The number to convert. /// An array of bytes with length 4. public static byte[] GetBytes(float value) { return !IsLittleEndian ? BitConverter.GetBytes(value) : BitConverter.GetBytes(value).Reverse().ToArray(); } /// /// Returns the specified 32-bit signed integer value as an array of bytes. /// /// The number to convert. /// An array of bytes with length 4. public static byte[] GetBytes(int value) { return !IsLittleEndian ? BitConverter.GetBytes(value) : BitConverter.GetBytes(value).Reverse().ToArray(); } /// /// Returns the specified 64-bit signed integer value as an array of bytes. /// /// The number to convert. /// An array of bytes with length 8. public static byte[] GetBytes(long value) { return !IsLittleEndian ? BitConverter.GetBytes(value) : BitConverter.GetBytes(value).Reverse().ToArray(); } /// /// Returns the specified 16-bit signed integer value as an array of bytes. /// /// The number to convert. /// An array of bytes with length 2. public static byte[] GetBytes(short value) { return !IsLittleEndian ? BitConverter.GetBytes(value) : BitConverter.GetBytes(value).Reverse().ToArray(); } /// /// Returns the specified 32-bit unsigned integer value as an array of bytes. /// /// The number to convert. /// An array of bytes with length 4. public static byte[] GetBytes(uint value) { return !IsLittleEndian ? BitConverter.GetBytes(value) : BitConverter.GetBytes(value).Reverse().ToArray(); } /// /// Returns the specified 64-bit unsigned integer value as an array of bytes. /// /// The number to convert. /// An array of bytes with length 8. public static byte[] GetBytes(ulong value) { return !IsLittleEndian ? BitConverter.GetBytes(value) : BitConverter.GetBytes(value).Reverse().ToArray(); } /// /// Returns the specified 16-bit unsigned integer value as an array of bytes. /// /// The number to convert. /// An array of bytes with length 2. public static byte[] GetBytes(ushort value) { return !IsLittleEndian ? BitConverter.GetBytes(value) : BitConverter.GetBytes(value).Reverse().ToArray(); } /// /// Converts the specified 64-bit signed integer to a double-precision floating point number. /// /// The number to convert. /// A double-precision floating point number whose value is equivalent to value. public static double Int64BitsToDouble(long value) { throw new NotImplementedException(); } /// /// Returns a Boolean value converted from one byte at a specified position in a byte array. /// /// An array of bytes. /// The starting position within value. /// true if the byte at in value is nonzero; otherwise, false. /// value is null. /// /// is less than zero or greater than the /// length of value minus 1. /// public static bool ToBoolean(byte[] value, int startIndex) { throw new NotImplementedException(); } /// /// Returns a Unicode character converted from two bytes at a specified position in a byte array. /// /// An array. /// The starting position within value. /// A character formed by two bytes beginning at . /// equals the length of value minus 1. /// value is null. /// /// is less than zero or greater than the /// length of value minus 1. /// public static char ToChar(byte[] value, int startIndex) { throw new NotImplementedException(); } /// /// Returns a double-precision floating point number converted from eight bytes at a specified position in a byte /// array. /// /// An array of bytes. /// The starting position within value. /// A double precision floating point number formed by eight bytes beginning at . /// /// is greater than or equal to the length of value /// minus 7, and is less than or equal to the length of value minus 1. /// /// value is null. /// /// is less than zero or greater than the /// length of value minus 1. /// public static double ToDouble(byte[] value, int startIndex) { throw new NotImplementedException(); } /// /// Returns a 16-bit signed integer converted from two bytes at a specified position in a byte array. /// /// An array of bytes. /// The starting position within value. /// A 16-bit signed integer formed by two bytes beginning at . /// equals the length of value minus 1. /// value is null. /// /// startIndex is less than zero or greater than the length of value /// minus 1. /// public static short ToInt16(byte[] value, int startIndex) { return !IsLittleEndian ? BitConverter.ToInt16(value, startIndex) : BitConverter.ToInt16(value.Reverse().ToArray(), value.Length - sizeof(short) - startIndex); } /// /// Returns a 32-bit signed integer converted from four bytes at a specified position in a byte array. /// /// An array of bytes. /// The starting position within value. /// A 32-bit signed integer formed by four bytes beginning at . /// /// is greater than or equal to the length of value /// minus 3, and is less than or equal to the length of value minus 1. /// /// value is null. /// /// startIndex is less than zero or greater than the length of value /// minus 1. /// public static int ToInt32(byte[] value, int startIndex) { return !IsLittleEndian ? BitConverter.ToInt32(value, startIndex) : BitConverter.ToInt32(value.Reverse().ToArray(), value.Length - sizeof(int) - startIndex); } /// /// Returns a 64-bit signed integer converted from eight bytes at a specified position in a byte array. /// /// An array of bytes. /// The starting position within value. /// A 64-bit signed integer formed by eight bytes beginning at . /// /// is greater than or equal to the length of value /// minus 7, and is less than or equal to the length of value minus 1. /// /// value is null. /// /// is less than zero or greater than the /// length of value minus 1. /// public static long ToInt64(byte[] value, int startIndex) { return !IsLittleEndian ? BitConverter.ToInt64(value, startIndex) : BitConverter.ToInt64(value.Reverse().ToArray(), value.Length - sizeof(long) - startIndex); } /// /// Returns a single-precision floating point number converted from four bytes at a specified position in a byte /// array. /// /// An array of bytes. /// The starting position within value. /// A single-precision floating point number formed by four bytes beginning at . /// /// is greater than or equal to the length of value /// minus 3, and is less than or equal to the length of value minus 1. /// /// value is null. /// /// is less than zero or greater than the /// length of value minus 1. /// public static float ToSingle(byte[] value, int startIndex) { return !IsLittleEndian ? BitConverter.ToSingle(value, startIndex) : BitConverter.ToSingle(value.Reverse().ToArray(), value.Length - sizeof(float) - startIndex); } /// /// Converts the numeric value of each element of a specified array of bytes to its equivalent hexadecimal string /// representation. /// /// An array of bytes. /// /// A System.String of hexadecimal pairs separated by hyphens, where each pair represents the corresponding /// element in value; for example, "7F-2C-4A". /// /// value is null. public static string ToString(byte[] value) { return !IsLittleEndian ? BitConverter.ToString(value) : BitConverter.ToString(value.Reverse().ToArray()); } /// /// Converts the numeric value of each element of a specified subarray of bytes to its equivalent hexadecimal string /// representation. /// /// An array of bytes. /// The starting position within value. /// /// A System.String of hexadecimal pairs separated by hyphens, where each pair represents the corresponding /// element in a subarray of value; for example, "7F-2C-4A". /// /// value is null. /// /// startIndex is less than zero or greater than the length of value /// minus 1. /// public static string ToString(byte[] value, int startIndex) { return !IsLittleEndian ? BitConverter.ToString(value, startIndex) : BitConverter.ToString(value.Reverse().ToArray(), startIndex); } /// /// Converts the numeric value of each element of a specified subarray of bytes to its equivalent hexadecimal string /// representation. /// /// An array of bytes. /// The starting position within value. /// The number of array elements in value to convert. /// /// A System.String of hexadecimal pairs separated by hyphens, where each pair represents the corresponding /// element in a subarray of value; for example, "7F-2C-4A". /// /// value is null. /// /// startIndex or length is less than zero. -or- startIndex is greater /// than zero and is greater than or equal to the length of value. /// /// /// The combination of startIndex and length does not specify a position within /// value; that is, the startIndex parameter is greater than the length of value minus the length parameter. /// public static string ToString(byte[] value, int startIndex, int length) { return !IsLittleEndian ? BitConverter.ToString(value, startIndex, length) : BitConverter.ToString(value.Reverse().ToArray(), startIndex, length); } /// /// Returns a 16-bit unsigned integer converted from two bytes at a specified position in a byte array. /// /// The array of bytes. /// The starting position within value. /// A 16-bit unsigned integer formed by two bytes beginning at startIndex. /// startIndex equals the length of value minus 1. /// value is null. /// /// startIndex is less than zero or greater than the length of value /// minus 1. /// public static ushort ToUInt16(byte[] value, int startIndex) { return !IsLittleEndian ? BitConverter.ToUInt16(value, startIndex) : BitConverter.ToUInt16(value.Reverse().ToArray(), value.Length - sizeof(ushort) - startIndex); } /// /// Returns a 32-bit unsigned integer converted from four bytes at a specified position in a byte array. /// /// An array of bytes. /// The starting position within value. /// A 32-bit unsigned integer formed by four bytes beginning at startIndex. /// /// startIndex is greater than or equal to the length of value minus 3, and is /// less than or equal to the length of value minus 1. /// /// value is null. /// /// startIndex is less than zero or greater than the length of value /// minus 1. /// public static uint ToUInt32(byte[] value, int startIndex) { return !IsLittleEndian ? BitConverter.ToUInt32(value, startIndex) : BitConverter.ToUInt32(value.Reverse().ToArray(), value.Length - sizeof(uint) - startIndex); } /// /// Returns a 64-bit unsigned integer converted from eight bytes at a specified position in a byte array. /// /// An array of bytes. /// The starting position within value. /// A 64-bit unsigned integer formed by the eight bytes beginning at startIndex. /// /// startIndex is greater than or equal to the length of value minus 7, and is /// less than or equal to the length of value minus 1. /// /// value is null. /// /// startIndex is less than zero or greater than the length of value /// minus 1. /// public static ulong ToUInt64(byte[] value, int startIndex) { return !IsLittleEndian ? BitConverter.ToUInt64(value, startIndex) : BitConverter.ToUInt64(value.Reverse().ToArray(), value.Length - sizeof(ulong) - startIndex); } public static Guid ToGuid(byte[] value, int startIndex) { return new Guid(ToUInt32(value, 0 + startIndex), ToUInt16(value, 4 + startIndex), ToUInt16(value, 6 + startIndex), value[8 + startIndex + 0], value[8 + startIndex + 1], value[8 + startIndex + 2], value[8 + startIndex + 3], value[8 + startIndex + 5], value[8 + startIndex + 5], value[8 + startIndex + 6], value[8 + startIndex + 7]); } } }