MixedCodeDocumentFragmentList.cs

// HtmlAgilityPack V1.0 - Simon Mourier <simon underscore mourier at hotmail dot com>
using System;
using System.Collections;
using System.Collections.Generic;

namespace HtmlAgilityPack
{
	/// <summary>
	/// Represents a list of mixed code fragments.
	/// </summary>
	public class MixedCodeDocumentFragmentList : IEnumerable<MixedCodeDocumentFragment>
	{
		#region Fields

		private MixedCodeDocument _doc;
		private List<MixedCodeDocumentFragment> _items = new List<MixedCodeDocumentFragment>();

		#endregion

		#region Constructors

		internal MixedCodeDocumentFragmentList(MixedCodeDocument doc)
		{
			_doc = doc;
		}

		#endregion

		#region Properties

		///<summary>
		/// Gets the Document
		///</summary>
		public MixedCodeDocument Doc
		{
			get { return _doc; }
		}

		/// <summary>
		/// Gets the number of fragments contained in the list.
		/// </summary>
		public int Count
		{
			get { return _items.Count; }
		}

		/// <summary>
		/// Gets a fragment from the list using its index.
		/// </summary>
		public MixedCodeDocumentFragment this[int index]
		{
			get { return _items[index]; }
		}

		#endregion

		#region IEnumerable Members

		/// <summary>
		/// Gets an enumerator that can iterate through the fragment list.
		/// </summary>
		IEnumerator IEnumerable.GetEnumerator()
		{
			return GetEnumerator();
		}

		#endregion

		#region Public Methods

		/// <summary>
		/// Appends a fragment to the list of fragments.
		/// </summary>
		/// <param name="newFragment">The fragment to append. May not be null.</param>
		public void Append(MixedCodeDocumentFragment newFragment)
		{
			if (newFragment == null)
			{
				throw new ArgumentNullException("newFragment");
			}
			_items.Add(newFragment);
		}

		/// <summary>
		/// Gets an enumerator that can iterate through the fragment list.
		/// </summary>
		public IEnumerator<MixedCodeDocumentFragment> GetEnumerator()
		{
			foreach (var item in _items)
				yield return item;
		}

		/// <summary>
		/// Prepends a fragment to the list of fragments.
		/// </summary>
		/// <param name="newFragment">The fragment to append. May not be null.</param>
		public void Prepend(MixedCodeDocumentFragment newFragment)
		{
			if (newFragment == null)
			{
				throw new ArgumentNullException("newFragment");
			}
			_items.Insert(0, newFragment);
		}

		/// <summary>
		/// Remove a fragment from the list of fragments. If this fragment was not in the list, an exception will be raised.
		/// </summary>
		/// <param name="fragment">The fragment to remove. May not be null.</param>
		public void Remove(MixedCodeDocumentFragment fragment)
		{
			if (fragment == null)
			{
				throw new ArgumentNullException("fragment");
			}
			int index = GetFragmentIndex(fragment);
			if (index == -1)
			{
				throw new IndexOutOfRangeException();
			}
			RemoveAt(index);
		}

		/// <summary>
		/// Remove all fragments from the list.
		/// </summary>
		public void RemoveAll()
		{
			_items.Clear();
		}

		/// <summary>
		/// Remove a fragment from the list of fragments, using its index in the list.
		/// </summary>
		/// <param name="index">The index of the fragment to remove.</param>
		public void RemoveAt(int index)
		{
			//MixedCodeDocumentFragment frag = (MixedCodeDocumentFragment) _items[index];
			_items.RemoveAt(index);
		}

		#endregion

		#region Internal Methods

		internal void Clear()
		{
			_items.Clear();
		}

		internal int GetFragmentIndex(MixedCodeDocumentFragment fragment)
		{
			if (fragment == null)
			{
				throw new ArgumentNullException("fragment");
			}
			for (int i = 0; i < _items.Count; i++)
			{
				if ((_items[i]) == fragment)
				{
					return i;
				}
			}
			return -1;
		}

		#endregion
	}
}