C#中Queue<T>类的使用以及部分方法的源代码分析
Queue<T>类
表示对象的先进先出集合。
队列在按接收顺序存储消息方面很实用,以便于进行顺序处理。 存储在 Queue,<T> 中的对象在一端插入,从还有一端移除。
Queue<T> 的容量是 Queue<T> 能够包括的元素数。 当向 Queue<T> 中加入元素时,将通过又一次分配内部数组来依据须要自己主动增大容量。
可通过调用 TrimExcess 来降低容量。
Queue<T> 接受 null 作为引用类型的有效值而且同意有反复的元素。
命名控件:System.Collections.Generic
程序集:System(在System.dll中)
语法:public class Queue<T>:IEnumerable<T>, ICollection, IEnumerable
List<T>实现了IList<T>、 ICollection<T>、IEnumerable<T>、IList、ICollection、IEnumerable接口
因此能够看出与List<T>相比:
Queue<T>没有继承ICollection<T>接口,由于这个接口定义的Add()和Remove()方法不能用于队列;
Queue<T>没有继承IList<T>接口,所以不能使用索引器訪问队列。
所以队列仅仅同意在队列的尾部加入元素。从队列的头部获取元素。
经常使用的Queue<T>类的成员:
Count : 返回队列中元素的个数。
Enqueue : 在队列一端加入一个元素。
Dequeue() : 从队列的头部读取和删除一个元素。
假设调用Dequeue()时,队列中没有元素就会抛出异常InvalidOperationException异常。
Peek(): 在队列的头部取出一个元素,但不删除它。
TrimExcess():重置队列的容量。 /******************************************************************************************************************************/ 经常使用Queue<T>类的成员函数的源代码例如以下: public T Dequeue() { if (this._size == 0) { ThrowHelper.ThrowInvalidOperationException(ExceptionResource.InvalidOperation_EmptyQueue); } T local = this._array[this._head]; this._array[this._head] = default(T); this._head = (this._head + 1) % this._array.Length; this._size--; this._version++; return local; } public void Enqueue(T item) { if (this._size == this._array.Length) { int capacity = (int) ((this._array.Length * 200L) / 100L); if (capacity < (this._array.Length + 4)) { capacity = this._array.Length + 4; } this.SetCapacity(capacity); } this._array[this._tail] = item; this._tail = (this._tail + 1) % this._array.Length; this._size++; this._version++; } public T Peek() { if (this._size == 0) { ThrowHelper.ThrowInvalidOperationException(ExceptionResource.InvalidOperation_EmptyQueue); } return this._array[this._head]; } public void TrimExcess() { int num = (int) (this._array.Length * 0.9); if (this._size < num) { this.SetCapacity(this._size); } } 上诉方法使用到的SetCapacity函数的源代码例如以下: private void SetCapacity(int capacity) { T[] destinationArray = new T[capacity]; if (this._size > 0) { if (this._head < this._tail) { Array.Copy(this._array, this._head, destinationArray, 0, this._size); } else { Array.Copy(this._array, this._head, destinationArray, 0, this._array.Length - this._head); Array.Copy(this._array, 0, destinationArray, this._array.Length - this._head, this._tail); } } this._array = destinationArray; this._head = 0; this._tail = (this._size == capacity) ? 0 : this._size; this._version++; } /*****************************************************************************************************************************************/ 演示样例: 以下的代码演示样例演示了 Queue<T> 泛型类的几个方法。
此代码演示样例创建一个具有默认容量的字符串队列,并使用 Enqueue 方法对五个字符串进行排队。 枚举队列元素,这不会更改队列的状态。 使用 Dequeue 方法使第一个字符串出列。 使用 Peek 方法查找队列中的下一项。然后使用 Dequeue 方法使该项出列。
使用 ToArray 方法创建一个数组并将队列元素拷贝到该数组,然后将该数组传递给接受 IEnumerable 的 Queue 构造函数以创建队列副本。 将显示副本的元素。 创建一个大小是队列大小两倍的数组,并使用 CopyTo 方法从数组中间開始复制数组元素。 再次使用 Queue1T> 构造函数创建第二个队列副本,此队列在開始处包括三个 null 元素。 使用 Contains 方法显示字符串“four”在第一个队列副本中。然后使用 Clear 方法清除此副本并由 Count 属性显示该队列为空。using System; using System.Collections.Generic; class Example { public static void Main() { Queue1string> numbers = new Queue1string>(); numbers.Enqueue("one"); numbers.Enqueue("two"); numbers.Enqueue("three"); numbers.Enqueue("four"); numbers.Enqueue("five"); // A queue can be enumerated without disturbing its contents. foreach( string number in numbers ) { Console.WriteLine(number); } Console.WriteLine("\nDequeuing '{0}'", numbers.Dequeue()); Console.WriteLine("Peek at next item to dequeue: {0}", numbers.Peek()); Console.WriteLine("Dequeuing '{0}'", numbers.Dequeue()); // Create a copy of the queue, using the ToArray method and the // constructor that accepts an IEnumerable. Queue1string> queueCopy = new Queue1string>(numbers.ToArray()); Console.WriteLine("\nContents of the first copy:"); foreach( string number in queueCopy ) { Console.WriteLine(number); } // Create an array twice the size of the queue and copy the // elements of the queue, starting at the middle of the // array. string[] array2 = new string[numbers.Count * 2]; numbers.CopyTo(array2, numbers.Count); // Create a second queue, using the constructor that accepts an // IEnumerable(Of T). Queue1string> queueCopy2 = new Queue1string>(array2); Console.WriteLine("\nContents of the second copy, with duplicates and nulls:"); foreach( string number in queueCopy2 ) { Console.WriteLine(number); } Console.WriteLine("\nqueueCopy.Contains(\"four\") = {0}", queueCopy.Contains("four")); Console.WriteLine("\nqueueCopy.Clear()"); queueCopy.Clear(); Console.WriteLine("\nqueueCopy.Count = {0}", queueCopy.Count); } } /* This code example produces the following output: one two three four five Dequeuing 'one' Peek at next item to dequeue: two Dequeuing 'two' Contents of the copy: three four five Contents of the second copy, with duplicates and nulls: three four five queueCopy.Contains("four") = True queueCopy.Clear() queueCopy.Count = 0 */