//******************************************************************************************************
// LittleEndian.cs - Gbtc
//
// Copyright © 2014, Grid Protection Alliance. All Rights Reserved.
//
// Licensed to the Grid Protection Alliance (GPA) under one or more contributor license agreements. See
// the NOTICE file distributed with this work for additional information regarding copyright ownership.
// The GPA licenses this file to you under the MIT License (MIT), the "License"; you may
// not use this file except in compliance with the License. You may obtain a copy of the License at:
//
// http://www.opensource.org/licenses/MIT
//
// Unless agreed to in writing, the subject software distributed under the License is distributed on an
// "AS-IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. Refer to the
// License for the specific language governing permissions and limitations.
//
// Code Modification History:
// ----------------------------------------------------------------------------------------------------
// 05/06/2014 - Steven E. Chisholm
// Generated original version of source code based on EndianOrder.cs
// 08/20/2014 - Steven E. Chisholm
// Added encoding for decimal numbers and support for pointer methods.
//
//******************************************************************************************************
#region [ Contributor License Agreements ]
/**************************************************************************\
Copyright © 2009 - J. Ritchie Carroll
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above
copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials provided
with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER "AS IS" AND ANY
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
\**************************************************************************/
#endregion
using System;
using System.Runtime.CompilerServices;
namespace GSF
{
///
/// Defines a set of little-endian byte order interoperability functions.
///
///
/// This class is setup to support aggressive in-lining of little endian conversions. Bounds
/// will not be checked as part of this function call, if bounds are violated, the exception
/// will be thrown at the level.
///
public static class LittleEndian
{
#region [ ToValue Pointer ]
///
/// Returns a value converted from one byte at a specified position in a byte array.
///
/// An array of bytes.
/// true if the byte at startIndex in value is nonzero; otherwise, false.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe bool ToBoolean(byte* buffer)
{
return buffer[0] != 0;
}
///
/// Returns a Unicode character converted from two bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// A character formed by two bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe char ToChar(byte* buffer)
{
return (char)ToInt16(buffer);
}
///
/// Returns a double-precision floating point number converted from eight bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// A double-precision floating point number formed by eight bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe double ToDouble(byte* buffer)
{
long int64 = ToInt64(buffer);
return *(double*)&int64;
}
///
/// Returns a 16-bit signed integer converted from two bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// A 16-bit signed integer formed by two bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe short ToInt16(byte* buffer)
{
return (short)((int)buffer[0] | (int)buffer[1] << 8);
}
///
/// Returns a 24-bit signed integer converted from three bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// A 24-bit signed integer formed by three bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe Int24 ToInt24(byte* buffer)
{
int int32 = buffer[0] |
buffer[1] << 8 |
buffer[2] << 16;
// Check bit 23, the sign bit in a signed 24-bit integer
if ((int32 & 0x00800000) > 0)
{
// If the sign-bit is set, this number will be negative - set all high-byte bits (keeps 32-bit number in 24-bit range)
int32 |= Int24.BitMask;
}
else
{
// If the sign-bit is not set, this number will be positive - clear all high-byte bits (keeps 32-bit number in 24-bit range)
int32 &= ~Int24.BitMask;
}
return (Int24)int32;
}
///
/// Returns a 32-bit signed integer converted from four bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// A 32-bit signed integer formed by four bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int ToInt32(byte* buffer)
{
return (int)buffer[0] |
(int)buffer[1] << 8 |
(int)buffer[2] << 16 |
(int)buffer[3] << 24;
}
///
/// Returns a 64-bit signed integer converted from eight bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// A 64-bit signed integer formed by eight bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe long ToInt64(byte* buffer)
{
return (long)buffer[0] |
(long)buffer[1] << 8 |
(long)buffer[2] << 16 |
(long)buffer[3] << 24 |
(long)buffer[4] << 32 |
(long)buffer[5] << 40 |
(long)buffer[6] << 48 |
(long)buffer[7] << 56;
}
///
/// Returns a single-precision floating point number converted from four bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// A single-precision floating point number formed by four bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe float ToSingle(byte* buffer)
{
int int32 = ToInt32(buffer);
return *(float*)&int32;
}
///
/// Returns a 16-bit unsigned integer converted from two bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// A 16-bit unsigned integer formed by two bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe ushort ToUInt16(byte* buffer)
{
return (ushort)ToInt16(buffer);
}
///
/// Returns a 24-bit unsigned integer converted from three bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// A 24-bit unsigned integer formed by three bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe UInt24 ToUInt24(byte* buffer)
{
return (UInt24)((uint)buffer[0] |
(uint)buffer[1] << 8 |
(uint)buffer[2] << 16);
}
///
/// Returns a 32-bit unsigned integer converted from four bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// A 32-bit unsigned integer formed by four bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe uint ToUInt32(byte* buffer)
{
return (uint)ToInt32(buffer);
}
///
/// Returns a 64-bit unsigned integer converted from eight bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// A 64-bit unsigned integer formed by eight bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe ulong ToUInt64(byte* value)
{
return (ulong)ToInt64(value);
}
///
/// Returns a 128-bit decimal converted from 16 bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// A 128-bit decimal formed by 16 bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe decimal ToDecimal(byte* buffer)
{
if (BitConverter.IsLittleEndian)
return *(decimal*)(buffer);
decimal returnValue;
byte* destination = (byte*)&returnValue;
//int flags
destination[0] = buffer[3];
destination[1] = buffer[2];
destination[2] = buffer[1];
destination[3] = buffer[0];
//int high
destination[4] = buffer[7];
destination[5] = buffer[6];
destination[6] = buffer[5];
destination[7] = buffer[4];
//int low
destination[8] = buffer[11];
destination[9] = buffer[10];
destination[10] = buffer[9];
destination[11] = buffer[8];
//int mid
destination[12] = buffer[15];
destination[13] = buffer[14];
destination[14] = buffer[13];
destination[15] = buffer[12];
return returnValue;
}
#endregion
#region [ ToValue Array ]
///
/// Returns a 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 startIndex in value is nonzero; otherwise, false.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static bool ToBoolean(byte[] buffer, int startIndex)
{
return buffer[startIndex] != 0;
}
///
/// Returns a Unicode character converted from two bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// The starting position within value.
/// A character formed by two bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static char ToChar(byte[] buffer, int startIndex)
{
return (char)ToInt16(buffer, startIndex);
}
///
/// Returns a double-precision floating point number converted from eight bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// The starting position within value.
/// A double-precision floating point number formed by eight bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe double ToDouble(byte[] buffer, int startIndex)
{
long int64 = ToInt64(buffer, startIndex);
return *(double*)&int64;
}
///
/// Returns a 16-bit signed integer converted from two bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// The starting position within value.
/// A 16-bit signed integer formed by two bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static short ToInt16(byte[] buffer, int startIndex)
{
return (short)((int)buffer[startIndex] | (int)buffer[startIndex + 1] << 8);
}
///
/// Returns a 24-bit signed integer converted from three bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// The starting position within value.
/// A 24-bit signed integer formed by three bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static Int24 ToInt24(byte[] buffer, int startIndex)
{
int int32 = buffer[startIndex + 0] |
buffer[startIndex + 1] << 8 |
buffer[startIndex + 2] << 16;
// Check bit 23, the sign bit in a signed 24-bit integer
if ((int32 & 0x00800000) > 0)
{
// If the sign-bit is set, this number will be negative - set all high-byte bits (keeps 32-bit number in 24-bit range)
int32 |= Int24.BitMask;
}
else
{
// If the sign-bit is not set, this number will be positive - clear all high-byte bits (keeps 32-bit number in 24-bit range)
int32 &= ~Int24.BitMask;
}
return (Int24)int32;
}
///
/// Returns a 32-bit signed integer converted from four bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// The starting position within value.
/// A 32-bit signed integer formed by four bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int ToInt32(byte[] buffer, int startIndex)
{
return (int)buffer[startIndex + 0] |
(int)buffer[startIndex + 1] << 8 |
(int)buffer[startIndex + 2] << 16 |
(int)buffer[startIndex + 3] << 24;
}
///
/// Returns a 64-bit signed integer converted from eight bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// The starting position within value.
/// A 64-bit signed integer formed by eight bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static long ToInt64(byte[] buffer, int startIndex)
{
return (long)buffer[startIndex + 0] |
(long)buffer[startIndex + 1] << 8 |
(long)buffer[startIndex + 2] << 16 |
(long)buffer[startIndex + 3] << 24 |
(long)buffer[startIndex + 4] << 32 |
(long)buffer[startIndex + 5] << 40 |
(long)buffer[startIndex + 6] << 48 |
(long)buffer[startIndex + 7] << 56;
}
///
/// Returns a single-precision floating point number converted from four bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// The starting position within value.
/// A single-precision floating point number formed by four bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe float ToSingle(byte[] buffer, int startIndex)
{
int int32 = ToInt32(buffer, startIndex);
return *(float*)&int32;
}
///
/// Returns a 16-bit unsigned integer converted from two bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// The starting position within value.
/// A 16-bit unsigned integer formed by two bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static ushort ToUInt16(byte[] buffer, int startIndex)
{
return (ushort)ToInt16(buffer, startIndex);
}
///
/// Returns a 24-bit unsigned integer converted from three bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// The starting position within value.
/// A 24-bit unsigned integer formed by three bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static UInt24 ToUInt24(byte[] buffer, int startIndex)
{
return (UInt24)((uint)buffer[startIndex + 0] |
(uint)buffer[startIndex + 1] << 8 |
(uint)buffer[startIndex + 2] << 16);
}
///
/// Returns a 32-bit unsigned integer converted from four bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// The starting position within value.
/// A 32-bit unsigned integer formed by four bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static uint ToUInt32(byte[] buffer, int startIndex)
{
return (uint)ToInt32(buffer, startIndex);
}
///
/// Returns a 64-bit unsigned integer converted from eight bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// The starting position within value.
/// A 64-bit unsigned integer formed by eight bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static ulong ToUInt64(byte[] value, int startIndex)
{
return (ulong)ToInt64(value, startIndex);
}
///
/// Returns a 128-bit decimal converted from 16 bytes, accounting for target endian-order, at a specified position in a byte array.
///
/// An array of bytes (i.e., buffer containing binary image of value).
/// The starting position within value.
/// A 128-bit decimal formed by 16 bytes beginning at startIndex.
/// value is null.
/// startIndex is less than zero or greater than the length of value minus 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe decimal ToDecimal(byte[] buffer, int startIndex)
{
buffer.ValidateParameters(startIndex, 16);
fixed (byte* ptr = &buffer[startIndex])
{
if (BitConverter.IsLittleEndian)
return *(decimal*)(ptr);
decimal returnValue;
byte* destination = (byte*)&returnValue;
//int flags
destination[0] = ptr[3];
destination[1] = ptr[2];
destination[2] = ptr[1];
destination[3] = ptr[0];
//int high
destination[4] = ptr[7];
destination[5] = ptr[6];
destination[6] = ptr[5];
destination[7] = ptr[4];
//int low
destination[8] = ptr[11];
destination[9] = ptr[10];
destination[10] = ptr[9];
destination[11] = ptr[8];
//int mid
destination[12] = ptr[15];
destination[13] = ptr[14];
destination[14] = ptr[13];
destination[15] = ptr[12];
return returnValue;
}
}
#endregion
#region [ GetBytes ]
///
/// Returns the specified value as an array of bytes in the target endian-order.
///
/// The value to convert.
/// An array of bytes with length 1.
/// Native value type to get bytes for.
/// type is not primitive.
/// Cannot get bytes for type.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static byte[] GetBytes(T value) where T : struct, IConvertible
{
if (!typeof(T).IsPrimitive)
throw new ArgumentException("Value type is not primitive", nameof(value));
IConvertible nativeValue = (IConvertible)value;
switch (nativeValue.GetTypeCode())
{
case TypeCode.Char:
return GetBytes(nativeValue.ToChar(null));
case TypeCode.Boolean:
return GetBytes(nativeValue.ToBoolean(null));
case TypeCode.Int16:
return GetBytes(nativeValue.ToInt16(null));
case TypeCode.UInt16:
return GetBytes(nativeValue.ToUInt16(null));
case TypeCode.Int32:
return GetBytes(nativeValue.ToInt32(null));
case TypeCode.UInt32:
return GetBytes(nativeValue.ToUInt32(null));
case TypeCode.Int64:
return GetBytes(nativeValue.ToInt64(null));
case TypeCode.UInt64:
return GetBytes(nativeValue.ToUInt64(null));
case TypeCode.Single:
return GetBytes(nativeValue.ToSingle(null));
case TypeCode.Double:
return GetBytes(nativeValue.ToDouble(null));
case TypeCode.Decimal:
return GetBytes(nativeValue.ToDecimal(null));
default:
throw new InvalidOperationException("Cannot get bytes for value type " + nativeValue.GetTypeCode());
}
}
///
/// Returns the specified value as an array of bytes in the target endian-order.
///
/// The value to convert.
/// An array of bytes with length 1.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static byte[] GetBytes(bool value)
{
return new[] { value ? (byte)1 : (byte)0 };
}
///
/// Returns the specified Unicode character value as an array of bytes in the target endian-order.
///
/// The Unicode character value to convert.
/// An array of bytes with length 2.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static byte[] GetBytes(char value)
{
return GetBytes((short)value);
}
///
/// Returns the specified double-precision floating point value as an array of bytes in the target endian-order.
///
/// The number to convert.
/// An array of bytes with length 8.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe byte[] GetBytes(double value)
{
return GetBytes(*(long*)&value);
}
///
/// Returns the specified 16-bit signed integer value as an array of bytes.
///
/// The number to convert.
/// An array of bytes with length 2.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static byte[] GetBytes(short value)
{
return new[]
{
(byte)value,
(byte)(value >> 8)
};
}
///
/// Returns the specified 24-bit signed integer value as an array of bytes.
///
/// The number to convert.
/// An array of bytes with length 3.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static byte[] GetBytes(Int24 value)
{
int int32 = value;
return new[]
{
(byte)int32,
(byte)(int32 >> 8),
(byte)(int32 >> 16)
};
}
///
/// Returns the specified 32-bit signed integer value as an array of bytes.
///
/// The number to convert.
/// An array of bytes with length 4.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static byte[] GetBytes(int value)
{
return new[]
{
(byte)value,
(byte)(value >> 8),
(byte)(value >> 16),
(byte)(value >> 24)
};
}
///
/// Returns the specified 64-bit signed integer value as an array of bytes.
///
/// The number to convert.
/// An array of bytes with length 8.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static byte[] GetBytes(long value)
{
return new[]
{
(byte)value,
(byte)(value >> 8),
(byte)(value >> 16),
(byte)(value >> 24),
(byte)(value >> 32),
(byte)(value >> 40),
(byte)(value >> 48),
(byte)(value >> 56)
};
}
///
/// Returns the specified single-precision floating point value as an array of bytes in the target endian-order.
///
/// The number to convert.
/// An array of bytes with length 4.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe byte[] GetBytes(float value)
{
return GetBytes(*(int*)&value);
}
///
/// Returns the specified 16-bit unsigned integer value as an array of bytes.
///
/// The number to convert.
/// An array of bytes with length 2.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static byte[] GetBytes(ushort value)
{
return GetBytes((short)value);
}
///
/// Returns the specified 24-bit unsigned integer value as an array of bytes.
///
/// The number to convert.
/// An array of bytes with length 3.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static byte[] GetBytes(UInt24 value)
{
uint uint32 = (uint)value;
return new[]
{
(byte)uint32,
(byte)(uint32 >> 8),
(byte)(uint32 >> 16)
};
}
///
/// Returns the specified 32-bit unsigned integer value as an array of bytes.
///
/// The number to convert.
/// An array of bytes with length 4.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static byte[] GetBytes(uint value)
{
return GetBytes((int)value);
}
///
/// Returns the specified 64-bit unsigned integer value as an array of bytes.
///
/// The number to convert.
/// An array of bytes with length 8.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static byte[] GetBytes(ulong value)
{
return GetBytes((long)value);
}
///
/// Returns the specified 128-bit decimal value as an array of bytes.
///
/// The number to convert.
/// An array of bytes with length 16.
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe byte[] GetBytes(decimal value)
{
byte[] destinationArray = new byte[16];
fixed (byte* destination = destinationArray)
{
if (BitConverter.IsLittleEndian)
{
*(decimal*)(destination) = value;
}
else
{
byte* ptr = (byte*)&value;
//int flags
destination[0] = ptr[3];
destination[1] = ptr[2];
destination[2] = ptr[1];
destination[3] = ptr[0];
//int high
destination[4] = ptr[7];
destination[5] = ptr[6];
destination[6] = ptr[5];
destination[7] = ptr[4];
//int low
destination[8] = ptr[11];
destination[9] = ptr[10];
destination[10] = ptr[9];
destination[11] = ptr[8];
//int mid
destination[12] = ptr[15];
destination[13] = ptr[14];
destination[14] = ptr[13];
destination[15] = ptr[12];
}
}
return destinationArray;
}
#endregion
#region [ Copy Bytes Array ]
///
/// Copies the specified primitive type value as an array of bytes in the target endian-order to the destination array.
///
/// The value to convert and copy.
/// The destination buffer.
/// The byte offset into .
/// Native value type to get bytes for.
/// type is not primitive.
/// Cannot get bytes for type.
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int CopyBytes(T value, byte[] destinationArray, int destinationIndex) where T : struct, IConvertible
{
if (!typeof(T).IsPrimitive)
throw new ArgumentException("Value type is not primitive", nameof(value));
IConvertible nativeValue = (IConvertible)value;
switch (nativeValue.GetTypeCode())
{
case TypeCode.Char:
return CopyBytes(nativeValue.ToChar(null), destinationArray, destinationIndex);
case TypeCode.Boolean:
return CopyBytes(nativeValue.ToBoolean(null), destinationArray, destinationIndex);
case TypeCode.Int16:
return CopyBytes(nativeValue.ToInt16(null), destinationArray, destinationIndex);
case TypeCode.UInt16:
return CopyBytes(nativeValue.ToUInt16(null), destinationArray, destinationIndex);
case TypeCode.Int32:
return CopyBytes(nativeValue.ToInt32(null), destinationArray, destinationIndex);
case TypeCode.UInt32:
return CopyBytes(nativeValue.ToUInt32(null), destinationArray, destinationIndex);
case TypeCode.Int64:
return CopyBytes(nativeValue.ToInt64(null), destinationArray, destinationIndex);
case TypeCode.UInt64:
return CopyBytes(nativeValue.ToUInt64(null), destinationArray, destinationIndex);
case TypeCode.Single:
return CopyBytes(nativeValue.ToSingle(null), destinationArray, destinationIndex);
case TypeCode.Double:
return CopyBytes(nativeValue.ToDouble(null), destinationArray, destinationIndex);
case TypeCode.Decimal:
return CopyBytes(nativeValue.ToDecimal(null), destinationArray, destinationIndex);
default:
throw new InvalidOperationException("Cannot copy bytes for value type " + nativeValue.GetTypeCode());
}
}
///
/// Copies the specified value as an array of 1 byte in the target endian-order to the destination array.
///
/// The value to convert and copy.
/// The destination buffer.
/// The byte offset into .
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int CopyBytes(bool value, byte[] destinationArray, int destinationIndex)
{
destinationArray[destinationIndex] = value ? (byte)1 : (byte)0;
return 1;
}
///
/// Copies the specified Unicode character value as an array of 2 bytes in the target endian-order to the destination array.
///
/// The Unicode character value to convert and copy.
/// The destination buffer.
/// The byte offset into .
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int CopyBytes(char value, byte[] destinationArray, int destinationIndex)
{
return CopyBytes((short)value, destinationArray, destinationIndex);
}
///
/// Copies the specified double-precision floating point value as an array of 8 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// The byte offset into .
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(double value, byte[] destinationArray, int destinationIndex)
{
return CopyBytes(*(long*)&value, destinationArray, destinationIndex);
}
///
/// Copies the specified 16-bit signed integer value as an array of 2 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// The byte offset into .
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int CopyBytes(short value, byte[] destinationArray, int destinationIndex)
{
destinationArray[destinationIndex] = (byte)value;
destinationArray[destinationIndex + 1] = (byte)(value >> 8);
return 2;
}
///
/// Copies the specified 24-bit signed integer value as an array of 3 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// The byte offset into .
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int CopyBytes(Int24 value, byte[] destinationArray, int destinationIndex)
{
int int32 = value;
destinationArray[destinationIndex + 0] = (byte)int32;
destinationArray[destinationIndex + 1] = (byte)(int32 >> 8);
destinationArray[destinationIndex + 2] = (byte)(int32 >> 16);
return 3;
}
///
/// Copies the specified 32-bit signed integer value as an array of 4 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// The byte offset into .
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int CopyBytes(int value, byte[] destinationArray, int destinationIndex)
{
destinationArray[destinationIndex + 0] = (byte)value;
destinationArray[destinationIndex + 1] = (byte)(value >> 8);
destinationArray[destinationIndex + 2] = (byte)(value >> 16);
destinationArray[destinationIndex + 3] = (byte)(value >> 24);
return 4;
}
///
/// Copies the specified 64-bit signed integer value as an array of 8 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// The byte offset into .
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int CopyBytes(long value, byte[] destinationArray, int destinationIndex)
{
destinationArray[destinationIndex + 0] = (byte)value;
destinationArray[destinationIndex + 1] = (byte)(value >> 8);
destinationArray[destinationIndex + 2] = (byte)(value >> 16);
destinationArray[destinationIndex + 3] = (byte)(value >> 24);
destinationArray[destinationIndex + 4] = (byte)(value >> 32);
destinationArray[destinationIndex + 5] = (byte)(value >> 40);
destinationArray[destinationIndex + 6] = (byte)(value >> 48);
destinationArray[destinationIndex + 7] = (byte)(value >> 56);
return 8;
}
///
/// Copies the specified single-precision floating point value as an array of 4 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// The byte offset into .
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(float value, byte[] destinationArray, int destinationIndex)
{
return CopyBytes(*(int*)&value, destinationArray, destinationIndex);
}
///
/// Copies the specified 16-bit unsigned integer value as an array of 2 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// The byte offset into .
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int CopyBytes(ushort value, byte[] destinationArray, int destinationIndex)
{
return CopyBytes((short)value, destinationArray, destinationIndex);
}
///
/// Copies the specified 24-bit unsigned integer value as an array of 3 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// The byte offset into .
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int CopyBytes(UInt24 value, byte[] destinationArray, int destinationIndex)
{
uint uint32 = value;
destinationArray[destinationIndex + 0] = (byte)uint32;
destinationArray[destinationIndex + 1] = (byte)(uint32 >> 8);
destinationArray[destinationIndex + 2] = (byte)(uint32 >> 16);
return 3;
}
///
/// Copies the specified 32-bit unsigned integer value as an array of 4 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// The byte offset into .
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int CopyBytes(uint value, byte[] destinationArray, int destinationIndex)
{
return CopyBytes((int)value, destinationArray, destinationIndex);
}
///
/// Copies the specified 64-bit unsigned integer value as an array of 8 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// The byte offset into .
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int CopyBytes(ulong value, byte[] destinationArray, int destinationIndex)
{
return CopyBytes((long)value, destinationArray, destinationIndex);
}
///
/// Copies the specified 128-bit decimal value as an array of 16 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// The byte offset into .
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(decimal value, byte[] destinationArray, int destinationIndex)
{
destinationArray.ValidateParameters(destinationIndex, 16);
fixed (byte* destination = &destinationArray[destinationIndex])
{
if (BitConverter.IsLittleEndian)
{
*(decimal*)(destination) = value;
}
else
{
byte* ptr = (byte*)&value;
//int flags
destination[0] = ptr[3];
destination[1] = ptr[2];
destination[2] = ptr[1];
destination[3] = ptr[0];
//int high
destination[4] = ptr[7];
destination[5] = ptr[6];
destination[6] = ptr[5];
destination[7] = ptr[4];
//int low
destination[8] = ptr[11];
destination[9] = ptr[10];
destination[10] = ptr[9];
destination[11] = ptr[8];
//int mid
destination[12] = ptr[15];
destination[13] = ptr[14];
destination[14] = ptr[13];
destination[15] = ptr[12];
}
}
return 16;
}
#endregion
#region [ Copy Bytes Pointers ]
///
/// Copies the specified primitive type value as an array of bytes in the target endian-order to the destination array.
///
/// The value to convert and copy.
/// The destination buffer.
/// Native value type to get bytes for.
/// type is not primitive.
/// Cannot get bytes for type.
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(T value, byte* destination) where T : struct, IConvertible
{
if (!typeof(T).IsPrimitive)
throw new ArgumentException("Value type is not primitive", nameof(value));
IConvertible nativeValue = (IConvertible)value;
switch (nativeValue.GetTypeCode())
{
case TypeCode.Char:
return CopyBytes(nativeValue.ToChar(null), destination);
case TypeCode.Boolean:
return CopyBytes(nativeValue.ToBoolean(null), destination);
case TypeCode.Int16:
return CopyBytes(nativeValue.ToInt16(null), destination);
case TypeCode.UInt16:
return CopyBytes(nativeValue.ToUInt16(null), destination);
case TypeCode.Int32:
return CopyBytes(nativeValue.ToInt32(null), destination);
case TypeCode.UInt32:
return CopyBytes(nativeValue.ToUInt32(null), destination);
case TypeCode.Int64:
return CopyBytes(nativeValue.ToInt64(null), destination);
case TypeCode.UInt64:
return CopyBytes(nativeValue.ToUInt64(null), destination);
case TypeCode.Single:
return CopyBytes(nativeValue.ToSingle(null), destination);
case TypeCode.Double:
return CopyBytes(nativeValue.ToDouble(null), destination);
case TypeCode.Decimal:
return CopyBytes(nativeValue.ToDecimal(null), destination);
default:
throw new InvalidOperationException("Cannot copy bytes for value type " + nativeValue.GetTypeCode());
}
}
///
/// Copies the specified value as an array of 1 byte in the target endian-order to the destination array.
///
/// The value to convert and copy.
/// The destination buffer.
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(bool value, byte* destination)
{
destination[0] = value ? (byte)1 : (byte)0;
return 1;
}
///
/// Copies the specified Unicode character value as an array of 2 bytes in the target endian-order to the destination array.
///
/// The Unicode character value to convert and copy.
/// The destination buffer.
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(char value, byte* destination)
{
return CopyBytes((short)value, destination);
}
///
/// Copies the specified double-precision floating point value as an array of 8 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(double value, byte* destination)
{
return CopyBytes(*(long*)&value, destination);
}
///
/// Copies the specified 16-bit signed integer value as an array of 2 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(short value, byte* destination)
{
destination[0] = (byte)value;
destination[1] = (byte)(value >> 8);
return 2;
}
///
/// Copies the specified 24-bit signed integer value as an array of 3 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(Int24 value, byte* destination)
{
int int32 = value;
destination[0] = (byte)int32;
destination[1] = (byte)(int32 >> 8);
destination[2] = (byte)(int32 >> 16);
return 3;
}
///
/// Copies the specified 32-bit signed integer value as an array of 4 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(int value, byte* destination)
{
destination[0] = (byte)value;
destination[1] = (byte)(value >> 8);
destination[2] = (byte)(value >> 16);
destination[3] = (byte)(value >> 24);
return 4;
}
///
/// Copies the specified 64-bit signed integer value as an array of 8 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(long value, byte* destination)
{
destination[0] = (byte)value;
destination[1] = (byte)(value >> 8);
destination[2] = (byte)(value >> 16);
destination[3] = (byte)(value >> 24);
destination[4] = (byte)(value >> 32);
destination[5] = (byte)(value >> 40);
destination[6] = (byte)(value >> 48);
destination[7] = (byte)(value >> 56);
return 8;
}
///
/// Copies the specified single-precision floating point value as an array of 4 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(float value, byte* destination)
{
return CopyBytes(*(int*)&value, destination);
}
///
/// Copies the specified 16-bit unsigned integer value as an array of 2 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(ushort value, byte* destination)
{
return CopyBytes((short)value, destination);
}
///
/// Copies the specified 24-bit unsigned integer value as an array of 3 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(UInt24 value, byte* destination)
{
uint uint32 = value;
destination[0] = (byte)uint32;
destination[1] = (byte)(uint32 >> 8);
destination[2] = (byte)(uint32 >> 16);
return 3;
}
///
/// Copies the specified 32-bit unsigned integer value as an array of 4 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(uint value, byte* destination)
{
return CopyBytes((int)value, destination);
}
///
/// Copies the specified 64-bit unsigned integer value as an array of 8 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(ulong value, byte* destination)
{
return CopyBytes((long)value, destination);
}
///
/// Copies the specified 128-bit decimal value as an array of 16 bytes in the target endian-order to the destination array.
///
/// The number to convert and copy.
/// The destination buffer.
/// Length of bytes copied into array based on size of .
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static unsafe int CopyBytes(decimal value, byte* destination)
{
if (BitConverter.IsLittleEndian)
{
*(decimal*)(destination) = value;
}
else
{
byte* ptr = (byte*)&value;
//int flags
destination[0] = ptr[3];
destination[1] = ptr[2];
destination[2] = ptr[1];
destination[3] = ptr[0];
//int high
destination[4] = ptr[7];
destination[5] = ptr[6];
destination[6] = ptr[5];
destination[7] = ptr[4];
//int low
destination[8] = ptr[11];
destination[9] = ptr[10];
destination[10] = ptr[9];
destination[11] = ptr[8];
//int mid
destination[12] = ptr[15];
destination[13] = ptr[14];
destination[14] = ptr[13];
destination[15] = ptr[12];
}
return 16;
}
#endregion
}
}