2016-12-29 21:09:49 +01:00
|
|
|
<?php
|
2016-08-16 06:46:26 +02:00
|
|
|
|
2016-05-24 18:47:14 +02:00
|
|
|
namespace Amp;
|
|
|
|
|
2017-12-03 02:07:46 +01:00
|
|
|
/**
|
|
|
|
* Emitter is a container for an iterator that can emit values using the emit() method and completed using the
|
|
|
|
* complete() and fail() methods of this object. The contained iterator may be accessed using the iterate()
|
|
|
|
* method. This object should not be part of a public API, but used internally to create and emit values to an
|
|
|
|
* iterator.
|
2020-03-28 12:23:46 +01:00
|
|
|
*
|
|
|
|
* @template TValue
|
2020-05-13 17:15:21 +02:00
|
|
|
*
|
|
|
|
* @deprecated Use {@see StreamSource} and {@see Stream} instead of {@see Emitter} and {@see Iterator}.
|
2017-12-03 02:07:46 +01:00
|
|
|
*/
|
2018-06-18 20:00:01 +02:00
|
|
|
final class Emitter
|
|
|
|
{
|
2020-03-28 12:23:46 +01:00
|
|
|
/** @var Iterator<TValue> Has public emit, complete, and fail methods. */
|
2017-12-20 17:30:43 +01:00
|
|
|
private $emitter;
|
|
|
|
|
2020-03-28 12:23:46 +01:00
|
|
|
/** @var Iterator<TValue> Hides producer methods. */
|
2017-12-03 02:07:46 +01:00
|
|
|
private $iterator;
|
|
|
|
|
2018-06-18 20:00:01 +02:00
|
|
|
public function __construct()
|
|
|
|
{
|
2018-01-13 17:36:01 +01:00
|
|
|
$this->emitter = new class implements Iterator {
|
2017-12-03 02:07:46 +01:00
|
|
|
use Internal\Producer {
|
|
|
|
emit as public;
|
|
|
|
complete as public;
|
|
|
|
fail as public;
|
2017-01-04 02:10:27 +01:00
|
|
|
}
|
2017-12-03 02:07:46 +01:00
|
|
|
};
|
2017-12-20 17:30:43 +01:00
|
|
|
|
2018-01-13 17:36:01 +01:00
|
|
|
$this->iterator = new Internal\PrivateIterator($this->emitter);
|
2017-12-03 02:07:46 +01:00
|
|
|
}
|
2017-01-04 02:10:27 +01:00
|
|
|
|
2017-12-03 02:07:46 +01:00
|
|
|
/**
|
2020-03-28 12:23:46 +01:00
|
|
|
* @return Iterator
|
|
|
|
* @psalm-return Iterator<TValue>
|
2017-12-03 02:07:46 +01:00
|
|
|
*/
|
2018-06-18 20:00:01 +02:00
|
|
|
public function iterate(): Iterator
|
|
|
|
{
|
2017-12-03 02:07:46 +01:00
|
|
|
return $this->iterator;
|
|
|
|
}
|
2017-01-04 02:10:27 +01:00
|
|
|
|
2017-12-03 02:07:46 +01:00
|
|
|
/**
|
|
|
|
* Emits a value to the iterator.
|
|
|
|
*
|
|
|
|
* @param mixed $value
|
|
|
|
*
|
2020-03-28 12:23:46 +01:00
|
|
|
* @psalm-param TValue $value
|
|
|
|
*
|
|
|
|
* @return Promise
|
|
|
|
* @psalm-return Promise<null>
|
|
|
|
* @psalm-suppress MixedInferredReturnType
|
|
|
|
* @psalm-suppress MixedReturnStatement
|
2017-12-03 02:07:46 +01:00
|
|
|
*/
|
2018-06-18 20:00:01 +02:00
|
|
|
public function emit($value): Promise
|
|
|
|
{
|
2020-03-28 12:23:46 +01:00
|
|
|
/** @psalm-suppress UndefinedInterfaceMethod */
|
2017-12-20 17:30:43 +01:00
|
|
|
return $this->emitter->emit($value);
|
2017-12-03 02:07:46 +01:00
|
|
|
}
|
2017-01-04 02:10:27 +01:00
|
|
|
|
2017-12-03 02:07:46 +01:00
|
|
|
/**
|
|
|
|
* Completes the iterator.
|
2020-03-28 12:23:46 +01:00
|
|
|
*
|
|
|
|
* @return void
|
2017-12-03 02:07:46 +01:00
|
|
|
*/
|
2018-06-18 20:00:01 +02:00
|
|
|
public function complete()
|
|
|
|
{
|
2020-03-28 12:23:46 +01:00
|
|
|
/** @psalm-suppress UndefinedInterfaceMethod */
|
2017-12-20 17:30:43 +01:00
|
|
|
$this->emitter->complete();
|
2017-12-03 02:07:46 +01:00
|
|
|
}
|
2016-06-01 18:19:19 +02:00
|
|
|
|
2017-12-03 02:07:46 +01:00
|
|
|
/**
|
|
|
|
* Fails the iterator with the given reason.
|
|
|
|
*
|
|
|
|
* @param \Throwable $reason
|
2020-03-28 12:23:46 +01:00
|
|
|
*
|
|
|
|
* @return void
|
2017-12-03 02:07:46 +01:00
|
|
|
*/
|
2018-06-18 20:00:01 +02:00
|
|
|
public function fail(\Throwable $reason)
|
|
|
|
{
|
2020-03-28 12:23:46 +01:00
|
|
|
/** @psalm-suppress UndefinedInterfaceMethod */
|
2017-12-20 17:30:43 +01:00
|
|
|
$this->emitter->fail($reason);
|
2016-05-24 18:47:14 +02:00
|
|
|
}
|
2017-12-03 02:07:46 +01:00
|
|
|
}
|