mirror of
https://github.com/danog/amp.git
synced 2024-12-13 01:47:33 +01:00
d48e6bd5d2
More PHP 7.1 to 8 types added.
85 lines
2.0 KiB
PHP
85 lines
2.0 KiB
PHP
<?php
|
|
|
|
namespace Amp;
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @template TValue
|
|
*
|
|
* @deprecated Use {@see PipelineSource} and {@see Pipeline} instead of {@see Emitter} and {@see Iterator}.
|
|
*/
|
|
final class Emitter
|
|
{
|
|
private Iterator $emitter;
|
|
|
|
private Internal\PrivateIterator $iterator;
|
|
|
|
public function __construct()
|
|
{
|
|
$this->emitter = new class implements Iterator {
|
|
use Internal\Producer {
|
|
emit as public;
|
|
complete as public;
|
|
fail as public;
|
|
}
|
|
};
|
|
|
|
$this->iterator = new Internal\PrivateIterator($this->emitter);
|
|
}
|
|
|
|
/**
|
|
* @return Iterator
|
|
* @psalm-return Iterator<TValue>
|
|
*/
|
|
public function iterate(): Iterator
|
|
{
|
|
return $this->iterator;
|
|
}
|
|
|
|
/**
|
|
* Emits a value to the iterator.
|
|
*
|
|
* @param mixed $value
|
|
*
|
|
* @psalm-param TValue $value
|
|
*
|
|
* @return Promise
|
|
* @psalm-return Promise<null>
|
|
* @psalm-suppress MixedInferredReturnType
|
|
* @psalm-suppress MixedReturnStatement
|
|
*/
|
|
public function emit($value): Promise
|
|
{
|
|
/** @psalm-suppress UndefinedInterfaceMethod */
|
|
return $this->emitter->emit($value);
|
|
}
|
|
|
|
/**
|
|
* Completes the iterator.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function complete(): void
|
|
{
|
|
/** @psalm-suppress UndefinedInterfaceMethod */
|
|
$this->emitter->complete();
|
|
}
|
|
|
|
/**
|
|
* Fails the iterator with the given reason.
|
|
*
|
|
* @param \Throwable $reason
|
|
*
|
|
* @return void
|
|
*/
|
|
public function fail(\Throwable $reason): void
|
|
{
|
|
/** @psalm-suppress UndefinedInterfaceMethod */
|
|
$this->emitter->fail($reason);
|
|
}
|
|
}
|