linux-packaging-mono/mcs/class/System/System.Collections.Generic/Queue.cs

//
// System.Collections.Generic.Queue
//
// Author:
//    Martin Baulig (martin@ximian.com)
//    Ben Maurer (bmaurer@ximian.com)
//
// (C) 2003, 2004 Novell, Inc.
//

//
// Copyright (C) 2004 Novell, Inc (http://www.novell.com)
//
// Permission is hereby granted, free of charge, to any person obtaining
// a copy of this software and associated documentation files (the
// "Software"), to deal in the Software without restriction, including
// without limitation the rights to use, copy, modify, merge, publish,
// distribute, sublicense, and/or sell copies of the Software, and to
// permit persons to whom the Software is furnished to do so, subject to
// the following conditions:
// 
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
// 
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//

using System;
using System.Runtime.InteropServices;
using System.Diagnostics;

namespace System.Collections.Generic
{
	[ComVisible(false)]
	[Serializable]
	[DebuggerDisplay ("Count={Count}")]
	[DebuggerTypeProxy (typeof (CollectionDebuggerView))]	
	public class Queue<T> : IEnumerable <T>, ICollection, IEnumerable
	{
		T [] _array;
		int _head;
		int _tail;
		int _size;
		int _version;
		
		public Queue ()
		{
			_array = new T [0];
		}
		
		public Queue (int capacity)
		{
			if (capacity < 0)
				throw new ArgumentOutOfRangeException ("capacity");

			_array = new T [capacity];
		}
		
		public Queue (IEnumerable <T> collection)
		{
			if (collection == null)
				throw new ArgumentNullException ("collection");

			var icoll = collection as ICollection<T>;
			var size = icoll != null ? icoll.Count : 0;

			_array = new T [size];

			foreach (T t in collection)
				Enqueue (t);
		}
		
		public void Clear ()
		{
			Array.Clear (_array, 0, _array.Length);
			
			_head = _tail = _size = 0;
			_version++;
		}
		
		public bool Contains (T item)
		{
			if (item == null) {
				foreach (T t in this)
					if (t == null)
						return true;
			} else {
				foreach (T t in this)
					if (item.Equals (t))
						return true;
			}
			
			return false;
		}
		
		public void CopyTo (T [] array, int arrayIndex)
		{
			if (array == null)
				throw new ArgumentNullException ();

			((ICollection) this).CopyTo (array, arrayIndex);
		}
		
		void ICollection.CopyTo (Array array, int idx)
		{
			if (array == null)
				throw new ArgumentNullException ();
			
			if ((uint) idx > (uint) array.Length)
				throw new ArgumentOutOfRangeException ();
			
			if (array.Length - idx < _size)
				throw new ArgumentOutOfRangeException ();
			
			if (_size == 0)
				return;
			
			try {
				int contents_length = _array.Length;
				int length_from_head = contents_length - _head;
				
				Array.Copy (_array, _head, array, idx, Math.Min (_size, length_from_head));
				if (_size > length_from_head)
					Array.Copy (_array, 0, array, 
						    idx  + length_from_head,
						    _size - length_from_head);
			} catch (ArrayTypeMismatchException) {
				throw new ArgumentException ();
			}
		}
		
		public T Dequeue ()
		{
			T ret = Peek ();
			
			// clear stuff out to make the GC happy
			_array [_head] = default (T);
			
			if (++_head == _array.Length)
				_head = 0;
			_size --;
			_version ++;
			
			return ret;
		}
		
		public T Peek ()
		{
			if (_size == 0)
				throw new InvalidOperationException ();
			
			return _array [_head];
		}
		
		public void Enqueue (T item)
		{
			if (_size == _array.Length || _tail == _array.Length)
				SetCapacity (Math.Max (Math.Max (_size, _tail) * 2, 4));
			
			_array [_tail] = item;
			
			if (++_tail == _array.Length)
				_tail = 0;
			
			_size ++;
			_version ++;
		}
		
		public T [] ToArray ()
		{
			T [] t = new T [_size];
			CopyTo (t, 0);
			return t;
		}

		public void TrimExcess ()
		{
			if (_size < _array.Length * 0.9)
				SetCapacity (_size);
		}
		
		void SetCapacity (int new_size)
		{
			if (new_size == _array.Length)
				return;
			
			if (new_size < _size)
				throw new InvalidOperationException ("shouldnt happen");
			
			T [] new_data = new T [new_size];
			if (_size > 0)
				CopyTo (new_data, 0);
			
			_array = new_data;
			_tail = _size;
			_head = 0;
			_version ++;
		}
		
		public int Count {
			get { return _size; }
		}
		
		bool ICollection.IsSynchronized {
			get { return false; }
		}
		
		object ICollection.SyncRoot {
			get { return this; }
		}
		
		public Enumerator GetEnumerator ()
		{
			return new Enumerator (this);
		}

		IEnumerator <T> IEnumerable<T>.GetEnumerator ()
		{
			return GetEnumerator ();
		}

		IEnumerator IEnumerable.GetEnumerator ()
		{
			return GetEnumerator ();
		}
		
		[Serializable]
		public struct Enumerator : IEnumerator <T>, IEnumerator, IDisposable {
			const int NOT_STARTED = -2;
			
			// this MUST be -1, because we depend on it in move next.
			// we just decr the _size, so, 0 - 1 == FINISHED
			const int FINISHED = -1;
			
			Queue <T> q;
			int idx;
			int ver;
			
			internal Enumerator (Queue <T> q)
			{
				this.q = q;
				idx = NOT_STARTED;
				ver = q._version;
			}
			
			// for some reason, MSFT added a dispose to this class
			// It means that in foreach, we must still do a try/finally. Broken?
			public void Dispose ()
			{
				idx = NOT_STARTED;
			}
			
			public bool MoveNext ()
			{
				if (ver != q._version)
					throw new InvalidOperationException ();
				
				if (idx == NOT_STARTED)
					idx = q._size;
				
				return idx != FINISHED && -- idx != FINISHED;
			}
			
			public T Current {
				get {
					if (idx < 0)
						throw new InvalidOperationException ();
					
					return q._array [(q._size - 1 - idx + q._head) % q._array.Length];
				}
			}
			
			void IEnumerator.Reset ()
			{
				if (ver != q._version)
					throw new InvalidOperationException ();
				
				idx = NOT_STARTED;
			}
			
			object IEnumerator.Current {
				get { return Current; }
			}
			
		}
	}
}