/// <summary>
/// 向数组中中添加新元素
/// <para>eg: CollectionAssert.AreEqual(new int[6] { 1, 2, 3, 4, 5, 6 }, ArrayHelper.Add(new int[5] { 1, 2, 3, 4, 5 }, 6));</para>
/// </summary>
/// <typeparam name="T">泛型</typeparam>
/// <param name="sourceArray">需要操作的数组</param>
/// <param name="item">需要添加数组项</param>
/// <returns>数组</returns>
public static T[] Add <T>(T[] sourceArray, T item)
{
ArgumentCheck.Begin().NotNull(sourceArray, "需要操作的数组").NotNull(item, "需要添加数组项");
int _count = sourceArray.Length;
Array.Resize <T>(ref sourceArray, _count + 1);
sourceArray[_count] = item;
return(sourceArray);
}
/// <summary>
/// 向数组中添加新数组；
/// <para>
/// eg: CollectionAssert.AreEqual(new int[7] { 1, 2, 3, 4, 5, 6, 7 },
/// ArrayHelper.AddRange(new int[5] { 1, 2, 3, 4, 5 }, new int[2] { 6, 7 }));
/// </para>
/// </summary>
/// <typeparam name="T">泛型</typeparam>
/// <param name="sourceArray">需要操作的数组</param>
/// <param name="addArray">被添加的数组</param>
/// <returns>数组</returns>
public static T[] AddRange <T>(T[] sourceArray, T[] addArray)
{
ArgumentCheck.Begin().NotNull(sourceArray, "需要操作的数组").NotNull(addArray, "被添加的数组");
int _count = sourceArray.Length;
int _addCount = addArray.Length;
Array.Resize <T>(ref sourceArray, _count + _addCount);
addArray.CopyTo(sourceArray, _count);
return(sourceArray);
}
/// <summary>
/// 复制数组
/// <para>
/// eg: CollectionAssert.AreEqual(new int[3] { 1, 2, 3 }, ArrayHelper.Copy(new int[5] { 1,
/// 2, 3, 4, 5 }, 0, 3));
/// </para>
/// </summary>
/// <typeparam name="T">泛型</typeparam>
/// <param name="sourceArray">需要操作数组</param>
/// <param name="startIndex">复制起始索引，从零开始</param>
/// <param name="endIndex">复制结束索引</param>
/// <returns>数组</returns>
public static T[] Copy <T>(T[] sourceArray, int startIndex, int endIndex)
{
ArgumentCheck.Begin().NotNull(sourceArray, "需要操作的数组")
.CheckGreaterThan <int>(startIndex, "复制起始索引", 0, true)
.CheckGreaterThan <int>(endIndex, "复制结束索引", startIndex, false)
.CheckLessThan <int>(endIndex, "复制结束索引", sourceArray.Length, true);
int _len = endIndex - startIndex;
T[] _destination = new T[_len];
Array.Copy(sourceArray, startIndex, _destination, 0, _len);
return(_destination);
}
/// <summary>
/// 判断数组的值是否相等
/// <para> eg: Assert.IsTrue(ArrayHelper.CompletelyEqual(new int[5] { 1, 2, 3, 4, 5 }, new int[5] { 1, 2, 3, 4, 5 }));
/// </para>
/// </summary>
/// <typeparam name="T">泛型</typeparam>
/// <param name="sourceArray">数组一</param>
/// <param name="compareArray">数组二</param>
/// <returns>是否相等</returns>
public static bool CompletelyEqual <T>(this T[] sourceArray, T[] compareArray)
{
ArgumentCheck.Begin().NotNull(sourceArray, "需要操作的数组").NotNull(compareArray, "被比较的数组");
if (sourceArray == null || compareArray == null)
{
return(false);
}
if (sourceArray.Length != compareArray.Length)
{
return(false);
}
for (int i = 0; i < sourceArray.Length; i++)
{
if (!sourceArray[i].Equals(compareArray[i]))
{
return(false);
}
}
return(true);
}
/// <summary>
/// 清空数组
/// <para>
/// eg:
/// int[] _test = new int[5] { 1, 2, 3, 4, 5 };
/// _test.ClearAll();
/// CollectionAssert.AreEqual(new int[5] { 0, 0, 0, 0, 0 }, _test);
/// </para>
/// </summary>
/// <param name="sourceArray">数组</param>
public static void ClearAll(Array sourceArray)
{
ArgumentCheck.Begin().NotNull(sourceArray, "需要操作的数组");
Array.Clear(sourceArray, 0, sourceArray.Length);
}