using System; using System.Text; using Org.BouncyCastle.Math; namespace Org.BouncyCastle.Utilities { /// General array utilities. public abstract class Arrays { public static readonly byte[] EmptyBytes = new byte[0]; public static readonly int[] EmptyInts = new int[0]; public static bool AreAllZeroes(byte[] buf, int off, int len) { uint bits = 0; for (int i = 0; i < len; ++i) { bits |= buf[off + i]; } return bits == 0; } #if NETCOREAPP2_1_OR_GREATER || NETSTANDARD2_1_OR_GREATER public static bool AreAllZeroes(ReadOnlySpan buf) { uint bits = 0; for (int i = 0; i < buf.Length; ++i) { bits |= buf[i]; } return bits == 0; } #endif public static bool AreEqual( bool[] a, bool[] b) { if (a == b) return true; if (a == null || b == null) return false; return HaveSameContents(a, b); } public static bool AreEqual( char[] a, char[] b) { if (a == b) return true; if (a == null || b == null) return false; return HaveSameContents(a, b); } /// /// Are two arrays equal. /// /// Left side. /// Right side. /// True if equal. public static bool AreEqual(byte[] a, byte[] b) { if (a == b) return true; if (a == null || b == null) return false; return HaveSameContents(a, b); } public static bool AreEqual(byte[] a, int aFromIndex, int aToIndex, byte[] b, int bFromIndex, int bToIndex) { int aLength = aToIndex - aFromIndex; int bLength = bToIndex - bFromIndex; if (aLength != bLength) return false; for (int i = 0; i < aLength; ++i) { if (a[aFromIndex + i] != b[bFromIndex + i]) return false; } return true; } /// /// A constant time equals comparison - does not terminate early if /// test will fail. /// /// first array /// second array /// true if arrays equal, false otherwise. public static bool ConstantTimeAreEqual(byte[] a, byte[] b) { if (null == a || null == b) return false; if (a == b) return true; int len = System.Math.Min(a.Length, b.Length); int nonEqual = a.Length ^ b.Length; for (int i = 0; i < len; ++i) { nonEqual |= (a[i] ^ b[i]); } for (int i = len; i < b.Length; ++i) { nonEqual |= (b[i] ^ ~b[i]); } return 0 == nonEqual; } public static bool ConstantTimeAreEqual(int len, byte[] a, int aOff, byte[] b, int bOff) { if (null == a) throw new ArgumentNullException("a"); if (null == b) throw new ArgumentNullException("b"); if (len < 0) throw new ArgumentException("cannot be negative", "len"); if (aOff > (a.Length - len)) throw new IndexOutOfRangeException("'aOff' value invalid for specified length"); if (bOff > (b.Length - len)) throw new IndexOutOfRangeException("'bOff' value invalid for specified length"); int d = 0; for (int i = 0; i < len; ++i) { d |= a[aOff + i] ^ b[bOff + i]; } return 0 == d; } #if NETCOREAPP2_1_OR_GREATER || NETSTANDARD2_1_OR_GREATER public static bool ConstantTimeAreEqual(Span a, Span b) { if (a.Length != b.Length) throw new ArgumentException("Spans to compare must have equal length"); int d = 0; for (int i = 0, count = a.Length; i < count; ++i) { d |= a[i] ^ b[i]; } return 0 == d; } #endif public static bool AreEqual( int[] a, int[] b) { if (a == b) return true; if (a == null || b == null) return false; return HaveSameContents(a, b); } [CLSCompliant(false)] public static bool AreEqual(uint[] a, uint[] b) { if (a == b) return true; if (a == null || b == null) return false; return HaveSameContents(a, b); } public static bool AreEqual(long[] a, long[] b) { if (a == b) return true; if (a == null || b == null) return false; return HaveSameContents(a, b); } [CLSCompliant(false)] public static bool AreEqual(ulong[] a, ulong[] b) { if (a == b) return true; if (a == null || b == null) return false; return HaveSameContents(a, b); } private static bool HaveSameContents( bool[] a, bool[] b) { int i = a.Length; if (i != b.Length) return false; while (i != 0) { --i; if (a[i] != b[i]) return false; } return true; } private static bool HaveSameContents( char[] a, char[] b) { int i = a.Length; if (i != b.Length) return false; while (i != 0) { --i; if (a[i] != b[i]) return false; } return true; } private static bool HaveSameContents( byte[] a, byte[] b) { int i = a.Length; if (i != b.Length) return false; while (i != 0) { --i; if (a[i] != b[i]) return false; } return true; } private static bool HaveSameContents( int[] a, int[] b) { int i = a.Length; if (i != b.Length) return false; while (i != 0) { --i; if (a[i] != b[i]) return false; } return true; } private static bool HaveSameContents(uint[] a, uint[] b) { int i = a.Length; if (i != b.Length) return false; while (i != 0) { --i; if (a[i] != b[i]) return false; } return true; } private static bool HaveSameContents(long[] a, long[] b) { int i = a.Length; if (i != b.Length) return false; while (i != 0) { --i; if (a[i] != b[i]) return false; } return true; } private static bool HaveSameContents(ulong[] a, ulong[] b) { int i = a.Length; if (i != b.Length) return false; while (i != 0) { --i; if (a[i] != b[i]) return false; } return true; } public static string ToString( object[] a) { StringBuilder sb = new StringBuilder("["); if (a.Length > 0) { sb.Append(a[0]); for (int index = 1; index < a.Length; ++index) { sb.Append(", ").Append(a[index]); } } sb.Append(']'); return sb.ToString(); } public static int GetHashCode(byte[] data) { if (data == null) { return 0; } int i = data.Length; int hc = i + 1; while (--i >= 0) { hc *= 257; hc ^= data[i]; } return hc; } public static int GetHashCode(byte[] data, int off, int len) { if (data == null) { return 0; } int i = len; int hc = i + 1; while (--i >= 0) { hc *= 257; hc ^= data[off + i]; } return hc; } public static int GetHashCode(int[] data) { if (data == null) return 0; int i = data.Length; int hc = i + 1; while (--i >= 0) { hc *= 257; hc ^= data[i]; } return hc; } [CLSCompliant(false)] public static int GetHashCode(ushort[] data) { if (data == null) return 0; int i = data.Length; int hc = i + 1; while (--i >= 0) { hc *= 257; hc ^= data[i]; } return hc; } public static int GetHashCode(int[] data, int off, int len) { if (data == null) return 0; int i = len; int hc = i + 1; while (--i >= 0) { hc *= 257; hc ^= data[off + i]; } return hc; } [CLSCompliant(false)] public static int GetHashCode(uint[] data) { if (data == null) return 0; int i = data.Length; int hc = i + 1; while (--i >= 0) { hc *= 257; hc ^= (int)data[i]; } return hc; } [CLSCompliant(false)] public static int GetHashCode(uint[] data, int off, int len) { if (data == null) return 0; int i = len; int hc = i + 1; while (--i >= 0) { hc *= 257; hc ^= (int)data[off + i]; } return hc; } [CLSCompliant(false)] public static int GetHashCode(ulong[] data) { if (data == null) return 0; int i = data.Length; int hc = i + 1; while (--i >= 0) { ulong di = data[i]; hc *= 257; hc ^= (int)di; hc *= 257; hc ^= (int)(di >> 32); } return hc; } [CLSCompliant(false)] public static int GetHashCode(ulong[] data, int off, int len) { if (data == null) return 0; int i = len; int hc = i + 1; while (--i >= 0) { ulong di = data[off + i]; hc *= 257; hc ^= (int)di; hc *= 257; hc ^= (int)(di >> 32); } return hc; } public static bool[] Clone(bool[] data) { return data == null ? null : (bool[])data.Clone(); } public static byte[] Clone(byte[] data) { return data == null ? null : (byte[])data.Clone(); } public static short[] Clone(short[] data) { return data == null ? null : (short[])data.Clone(); } [CLSCompliant(false)] public static ushort[] Clone(ushort[] data) { return data == null ? null : (ushort[])data.Clone(); } public static int[] Clone(int[] data) { return data == null ? null : (int[])data.Clone(); } [CLSCompliant(false)] public static uint[] Clone(uint[] data) { return data == null ? null : (uint[])data.Clone(); } public static long[] Clone(long[] data) { return data == null ? null : (long[])data.Clone(); } [CLSCompliant(false)] public static ulong[] Clone(ulong[] data) { return data == null ? null : (ulong[])data.Clone(); } public static byte[] Clone(byte[] data, byte[] existing) { if (data == null) return null; if (existing == null || existing.Length != data.Length) return Clone(data); Array.Copy(data, 0, existing, 0, existing.Length); return existing; } [CLSCompliant(false)] public static ulong[] Clone(ulong[] data, ulong[] existing) { if (data == null) return null; if (existing == null || existing.Length != data.Length) return Clone(data); Array.Copy(data, 0, existing, 0, existing.Length); return existing; } public static bool Contains(byte[] a, byte n) { for (int i = 0; i < a.Length; ++i) { if (a[i] == n) return true; } return false; } public static bool Contains(short[] a, short n) { for (int i = 0; i < a.Length; ++i) { if (a[i] == n) return true; } return false; } public static bool Contains(int[] a, int n) { for (int i = 0; i < a.Length; ++i) { if (a[i] == n) return true; } return false; } public static void Fill( byte[] buf, byte b) { int i = buf.Length; while (i > 0) { buf[--i] = b; } } [CLSCompliant(false)] public static void Fill( ulong[] buf, ulong b) { int i = buf.Length; while (i > 0) { buf[--i] = b; } } public static void Fill(byte[] buf, int from, int to, byte b) { for (int i = from; i < to; ++i) { buf[i] = b; } } public static void Fill(T[] ts, T t) { for (int i = 0; i < ts.Length; ++i) { ts[i] = t; } } #if NETCOREAPP2_1_OR_GREATER || NETSTANDARD2_1_OR_GREATER public static void Fill(Span ts, T t) { for (int i = 0; i < ts.Length; ++i) { ts[i] = t; } } #endif public static byte[] CopyOf(byte[] data, int newLength) { byte[] tmp = new byte[newLength]; Array.Copy(data, 0, tmp, 0, System.Math.Min(newLength, data.Length)); return tmp; } public static char[] CopyOf(char[] data, int newLength) { char[] tmp = new char[newLength]; Array.Copy(data, 0, tmp, 0, System.Math.Min(newLength, data.Length)); return tmp; } public static int[] CopyOf(int[] data, int newLength) { int[] tmp = new int[newLength]; Array.Copy(data, 0, tmp, 0, System.Math.Min(newLength, data.Length)); return tmp; } [CLSCompliant(false)] public static uint[] CopyOf(uint[] data, int newLength) { uint[] tmp = new uint[newLength]; Array.Copy(data, 0, tmp, 0, System.Math.Min(newLength, data.Length)); return tmp; } public static long[] CopyOf(long[] data, int newLength) { long[] tmp = new long[newLength]; Array.Copy(data, 0, tmp, 0, System.Math.Min(newLength, data.Length)); return tmp; } public static BigInteger[] CopyOf(BigInteger[] data, int newLength) { BigInteger[] tmp = new BigInteger[newLength]; Array.Copy(data, 0, tmp, 0, System.Math.Min(newLength, data.Length)); return tmp; } /** * Make a copy of a range of bytes from the passed in data array. The range can * extend beyond the end of the input array, in which case the return array will * be padded with zeroes. * * @param data the array from which the data is to be copied. * @param from the start index at which the copying should take place. * @param to the final index of the range (exclusive). * * @return a new byte array containing the range given. */ public static byte[] CopyOfRange(byte[] data, int from, int to) { int newLength = GetLength(from, to); byte[] tmp = new byte[newLength]; Array.Copy(data, from, tmp, 0, System.Math.Min(newLength, data.Length - from)); return tmp; } public static int[] CopyOfRange(int[] data, int from, int to) { int newLength = GetLength(from, to); int[] tmp = new int[newLength]; Array.Copy(data, from, tmp, 0, System.Math.Min(newLength, data.Length - from)); return tmp; } public static long[] CopyOfRange(long[] data, int from, int to) { int newLength = GetLength(from, to); long[] tmp = new long[newLength]; Array.Copy(data, from, tmp, 0, System.Math.Min(newLength, data.Length - from)); return tmp; } public static BigInteger[] CopyOfRange(BigInteger[] data, int from, int to) { int newLength = GetLength(from, to); BigInteger[] tmp = new BigInteger[newLength]; Array.Copy(data, from, tmp, 0, System.Math.Min(newLength, data.Length - from)); return tmp; } private static int GetLength(int from, int to) { int newLength = to - from; if (newLength < 0) throw new ArgumentException(from + " > " + to); return newLength; } public static byte[] Append(byte[] a, byte b) { if (a == null) return new byte[] { b }; int length = a.Length; byte[] result = new byte[length + 1]; Array.Copy(a, 0, result, 0, length); result[length] = b; return result; } public static short[] Append(short[] a, short b) { if (a == null) return new short[] { b }; int length = a.Length; short[] result = new short[length + 1]; Array.Copy(a, 0, result, 0, length); result[length] = b; return result; } public static int[] Append(int[] a, int b) { if (a == null) return new int[] { b }; int length = a.Length; int[] result = new int[length + 1]; Array.Copy(a, 0, result, 0, length); result[length] = b; return result; } public static byte[] Concatenate(byte[] a, byte[] b) { if (a == null) return Clone(b); if (b == null) return Clone(a); byte[] rv = new byte[a.Length + b.Length]; Array.Copy(a, 0, rv, 0, a.Length); Array.Copy(b, 0, rv, a.Length, b.Length); return rv; } [CLSCompliant(false)] public static ushort[] Concatenate(ushort[] a, ushort[] b) { if (a == null) return Clone(b); if (b == null) return Clone(a); ushort[] rv = new ushort[a.Length + b.Length]; Array.Copy(a, 0, rv, 0, a.Length); Array.Copy(b, 0, rv, a.Length, b.Length); return rv; } public static byte[] ConcatenateAll(params byte[][] vs) { byte[][] nonNull = new byte[vs.Length][]; int count = 0; int totalLength = 0; for (int i = 0; i < vs.Length; ++i) { byte[] v = vs[i]; if (v != null) { nonNull[count++] = v; totalLength += v.Length; } } byte[] result = new byte[totalLength]; int pos = 0; for (int j = 0; j < count; ++j) { byte[] v = nonNull[j]; Array.Copy(v, 0, result, pos, v.Length); pos += v.Length; } return result; } public static int[] Concatenate(int[] a, int[] b) { if (a == null) return Clone(b); if (b == null) return Clone(a); int[] rv = new int[a.Length + b.Length]; Array.Copy(a, 0, rv, 0, a.Length); Array.Copy(b, 0, rv, a.Length, b.Length); return rv; } [CLSCompliant(false)] public static uint[] Concatenate(uint[] a, uint[] b) { if (a == null) return Clone(b); if (b == null) return Clone(a); uint[] rv = new uint[a.Length + b.Length]; Array.Copy(a, 0, rv, 0, a.Length); Array.Copy(b, 0, rv, a.Length, b.Length); return rv; } public static byte[] Prepend(byte[] a, byte b) { if (a == null) return new byte[] { b }; int length = a.Length; byte[] result = new byte[length + 1]; Array.Copy(a, 0, result, 1, length); result[0] = b; return result; } public static short[] Prepend(short[] a, short b) { if (a == null) return new short[] { b }; int length = a.Length; short[] result = new short[length + 1]; Array.Copy(a, 0, result, 1, length); result[0] = b; return result; } public static int[] Prepend(int[] a, int b) { if (a == null) return new int[] { b }; int length = a.Length; int[] result = new int[length + 1]; Array.Copy(a, 0, result, 1, length); result[0] = b; return result; } public static byte[] Reverse(byte[] a) { if (a == null) return null; int p1 = 0, p2 = a.Length; byte[] result = new byte[p2]; while (--p2 >= 0) { result[p2] = a[p1++]; } return result; } public static int[] Reverse(int[] a) { if (a == null) return null; int p1 = 0, p2 = a.Length; int[] result = new int[p2]; while (--p2 >= 0) { result[p2] = a[p1++]; } return result; } public static T[] ReverseInPlace(T[] array) { if (null == array) return null; Array.Reverse(array); return array; } public static void Clear(byte[] data) { if (null != data) { Array.Clear(data, 0, data.Length); } } public static void Clear(int[] data) { if (null != data) { Array.Clear(data, 0, data.Length); } } public static bool IsNullOrContainsNull(object[] array) { if (null == array) return true; int count = array.Length; for (int i = 0; i < count; ++i) { if (null == array[i]) return true; } return false; } public static bool IsNullOrEmpty(byte[] array) { return null == array || array.Length < 1; } public static bool IsNullOrEmpty(object[] array) { return null == array || array.Length < 1; } #if NETCOREAPP2_1_OR_GREATER || NETSTANDARD2_1_OR_GREATER public static byte[] Concatenate(ReadOnlySpan a, ReadOnlySpan b) { byte[] rv = new byte[a.Length + b.Length]; a.CopyTo(rv); b.CopyTo(rv.AsSpan(a.Length)); return rv; } public static byte[] Concatenate(ReadOnlySpan a, ReadOnlySpan b, ReadOnlySpan c) { byte[] rv = new byte[a.Length + b.Length + c.Length]; a.CopyTo(rv); b.CopyTo(rv.AsSpan(a.Length)); c.CopyTo(rv.AsSpan(a.Length + b.Length)); return rv; } public static byte[] Concatenate(ReadOnlySpan a, ReadOnlySpan b, ReadOnlySpan c, ReadOnlySpan d) { byte[] rv = new byte[a.Length + b.Length + c.Length + d.Length]; a.CopyTo(rv); b.CopyTo(rv.AsSpan(a.Length)); c.CopyTo(rv.AsSpan(a.Length + b.Length)); d.CopyTo(rv.AsSpan(a.Length + b.Length + c.Length)); return rv; } #endif } }