RoutineHandle.cs

//MIT License
//
//Copyright (c) 2018 Tom Blind
//
//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;

namespace AsyncRoutines
{
	public struct RoutineHandle
	{
		private UInt64 id;
		private Routine routine;

		public RoutineHandle(Routine routine)
		{
			this.routine = routine;
			id = routine.Id;
		}

		/// <summary> Indicates if routine is stopped. </summary>
		public bool IsDead { get { return (routine == null || id != routine.Id || routine.IsDead); } }

		/// <summary> Stop the routine. </summary>
		public void Stop()
		{
			if (routine != null && id == routine.Id)
			{
				routine.Stop();
			}
		}

		/// <summary> Throw an exception in the routine. </summary>
		public void Throw(Exception exception)
		{
			if (routine != null && id == routine.Id)
			{
				routine.Throw(exception);
			}
		}
	}
}