monkey2/modules/std/fiber/future.monkey2

  
Namespace std.fiber

#if __TARGET__<>"emscripten"

#rem monkeydoc Futures provides support for simple fiber synchronization.

A future allows you to synchronize two fibers by providing a way for one fiber to signal to another that an operation has completed.

The general usage pattern of future is:

* Fiber A creates a future and passes it to fiber B.

* Fiber A then calls [[Get]] on the future. This will suspend Fiber A.

* Fiber B performs some operation, then calls [[Set]] on the future. This will resume Fiber A.

A future can be resued - each time [[Get]] is called, the fiber will suspend until another fiber calls [[Set]].

#end
Class Future<T>

	#rem monkeydoc Creates a new future.
	#end
	Method New()
		_fiber=Fiber.Current()
	End

	#rem monkeydoc Sets the future's value.
	#end	
	Method Set( value:T )
		_value=value
		_fiber.Resume()
	End
	
	#rem monkeydoc Gets the future's value.
	#end
	Method Get:T()
		Fiber.Suspend()
		Return _value
	End

	Private
		
	Field _fiber:Fiber
	Field _value:T
	
End

#endif