/*
 * CSet.cs
 * 
 * 作者：邱觀琛
 * 創建時間：2002-5-7
 * 最后修改：2002-6-28
 * 
 * 
 * 提供一些主要涉及到集合（指數組、ArrayList或DataView的單一字段）操作的函數，
 * 包括集合中元素的查找、統計、收集和其他處理等。
 * 
 */

using System;
using System.Data;
using System.Collections;

namespace CFC
{
	/// <summary>
	/// 提供一些主要涉及到集合操作的函數。
	/// </summary>
	public class CSet
	{
		private CSet()
		{
		}


		#region 在各種集合中查找單個元素的位置

		#region public static int IndexOf(object Element, DataView dv, string FieldName) : 在DataView中所有記錄在指定字段上的值的集合內查找某一對象的位置
		/// <summary>
		/// 在DataView中所有記錄在指定字段上的值的集合內查找某一對象，返回該對象的位置。
		/// 如果找不到，返回-1。
		/// </summary>
		/// <param name="Element">被查找的對象</param>
		/// <param name="dv">接受查找的DataView</param>
		/// <param name="FieldName">接受查找的字段名稱</param>
		/// <returns>被查找的對象的位置</returns>
		public static int IndexOf(object Element, DataView dv, string FieldName)
		{
			for (int i=0; i<dv.Count; i++)
			{
				if (Element.Equals(dv[i][FieldName])) return i;
			}
			return -1;
		}
		#endregion


		#region public static int IndexOf(string Element, DataView dv, string FieldName) : 在DataView中所有記錄在指定字段上的值的集合內查找某一字符串的位置
		/// <summary>
		/// 在DataView中所有記錄在指定字段上的值的集合內查找某一字符串，返回該字符串的位置。
		/// 如果找不到，返回-1。
		/// </summary>
		/// <param name="Element">被查找的字符串</param>
		/// <param name="dv">接受查找的DataView</param>
		/// <param name="FieldName">接受查找的字段名稱</param>
		/// <returns>被查找的字符串的位置</returns>
		public static int IndexOf(string Element, DataView dv, string FieldName)
		{
			for (int i=0; i<dv.Count; i++)
			{
				if (!CType.IsNull(dv[i][FieldName]))
					if (Element.Equals(dv[i][FieldName].ToString())) return i;
			}
			return -1;
		}
		#endregion


		#region public static int IndexOf(int Element, DataView dv, string FieldName) : 在DataView中所有記錄在指定字段上的值的集合內查找某一整數的位置
		/// <summary>
		/// 在DataView中所有記錄在指定字段上的值的集合內查找某一整數，返回該整數的位置。
		/// 如果找不到，返回-1。
		/// </summary>
		/// <param name="Element">被查找的整數</param>
		/// <param name="dv">接受查找的DataView</param>
		/// <param name="FieldName">接受查找的字段名稱</param>
		/// <returns>被查找的整數的位置</returns>
		public static int IndexOf(int Element, DataView dv, string FieldName)
		{
			for (int i=0; i<dv.Count; i++)
			{
				if (!CType.IsNull(dv[i][FieldName]))
					if (Element == Convert.ToInt16(dv[i][FieldName])) return i;
			}
			return -1;
		}
		#endregion


		#region public static int IndexOf(double Element, DataView dv, string FieldName) : 在DataView中所有記錄在指定字段上的值的集合內查找某一double數的位置
		/// <summary>
		/// 在DataView中所有記錄在指定字段上的值的集合內查找某一double數，返回該double數的位置。
		/// 如果找不到，返回-1。
		/// </summary>
		/// <param name="Element">被查找的double數</param>
		/// <param name="dv">接受查找的DataView</param>
		/// <param name="FieldName">接受查找的字段名稱</param>
		/// <returns>被查找的double數的位置</returns>
		public static int IndexOf(double Element, DataView dv, string FieldName)
		{
			for (int i=0; i<dv.Count; i++)
			{
				if (!CType.IsNull(dv[i][FieldName]))
					if (Element == Convert.ToDouble(dv[i][FieldName])) return i;
			}
			return -1;
		}
		#endregion


		#region public static int IndexOf(decimal Element, DataView dv, string FieldName) : 在DataView中所有記錄在指定字段上的值的集合內查找某一decimal數的位置
		/// <summary>
		/// 在DataView中所有記錄在指定字段上的值的集合內查找某一decimal數，返回該decimal數的位置。
		/// 如果找不到，返回-1。
		/// </summary>
		/// <param name="Element">被查找的decimal數</param>
		/// <param name="dv">接受查找的DataView</param>
		/// <param name="FieldName">接受查找的字段名稱</param>
		/// <returns>被查找的decimal數的位置</returns>
		public static int IndexOf(decimal Element, DataView dv, string FieldName)
		{
			for (int i=0; i<dv.Count; i++)
			{
				if (!CType.IsNull(dv[i][FieldName]))
					if (Element == Convert.ToDecimal(dv[i][FieldName])) return i;
			}
			return -1;
		}
		#endregion

		#endregion


		#region 收集DataView中所有記錄在指定字段上的值

		#region public static Array Collect(DataView dv, string FieldName, Type ElementType) : 將DataView中所有記錄在指定字段上的值收集到一個數組里面
		/// <summary>
		/// 將DataView中所有記錄在指定字段上的值收集到一個數組里面。
		/// </summary>
		/// <param name="dv">需要收集的DataView</param>
		/// <param name="FieldName">需要收集的字段名</param>
		/// <param name="ElementType">生成數組的元素的類型，亦即DataView的指定字段的類型</param>
		/// <returns>收集結果</returns>
		public static Array Collect(DataView dv, string FieldName, Type ElementType)
		{
			Array Result = Array.CreateInstance(ElementType,dv.Count);
			for (int i=0; i<dv.Count; i++)
			{
				Result.SetValue(dv[i][FieldName],i);
			}
			return Result;
		}
		#endregion


		#region public static ArrayList Collect(DataView dv, string FieldName) : 將DataView中所有記錄在指定字段上的值收集到一個ArrayList里面
		/// <summary>
		/// 將DataView中所有記錄在指定字段上的值收集到一個ArrayList里面。
		/// </summary>
		/// <param name="dv">需要收集的DataView</param>
		/// <param name="FieldName">需要收集的字段名</param>
		/// <returns>收集結果</returns>
		public static ArrayList Collect(DataView dv, string FieldName)
		{
			ArrayList Result = new ArrayList(dv.Count);
			for (int i=0; i<dv.Count; i++)
			{
				Result.Add(dv[i][FieldName]);
			}
			return Result;
		}
		#endregion

		#endregion


		#region 統計集合中所有元素的總和

		#region public static int Sum(int[] Values) : 統計整數數組的元素的總和
		/// <summary>
		/// 統計整數數組的元素的總和。
		/// </summary>
		/// <param name="Values">需要統計的整數數組</param>
		/// <returns>統計結果</returns>
		public static int Sum(int[] Values)
		{
			int Result = 0;;
			foreach (int Value in Values)
			{
				Result += Value;
			}
			return Result;
		}
		#endregion


		#region public static double Sum(double[] Values) : 統計double數組的元素的總和
		/// <summary>
		/// 統計double數組的元素的總和。
		/// </summary>
		/// <param name="Values">需要統計的double數組</param>
		/// <returns>統計結果</returns>
		public static double Sum(double[] Values)
		{
			double Result = 0;;
			foreach (double Value in Values)
			{
				Result += Value;
			}
			return Result;
		}
		#endregion


		#region public static decimal Sum(decimal[] Values) : 統計decimal數組的元素的總和
		/// <summary>
		/// 統計decimal數組的元素的總和。
		/// </summary>
		/// <param name="Values">需要統計的decimal數組</param>
		/// <returns>統計結果</returns>
		public static decimal Sum(decimal[] Values)
		{
			decimal Result = 0;;
			foreach (decimal Value in Values)
			{
				Result += Value;
			}
			return Result;
		}
		#endregion


		#region public static int Sum(DataView dv, string FieldName, int DefaultValue) : 統計DataView中所有記錄在指定字段上的值的總和
		/// <summary>
		/// 統計DataView中所有記錄在指定字段上的值的總和，該字段必須為整型。