Future.stub

<?php

namespace parallel;

use Throwable;

/**
 * @template T
 */
final class Future
{
    /* Resolution */

    /**
     * Shall return (and if necessary wait for) return from task
     *
     * @return T
     *
     * @throws Future\Error if waiting failed (internal error).
     * @throws Future\Error\Killed if \parallel\Runtime executing task was killed.
     * @throws Future\Error\Cancelled if task was cancelled.
     * @throws Future\Error\Foreign if task raised an unrecognized uncaught exception.
     * @throws Throwable Shall rethrow \Throwable uncaught in task
     */
    public function value() {}

    /* State */

    /**
     * Shall indicate if the task is completed
     * @return bool
     */
    public function done(): bool {}

    /**
     * Shall indicate if the task was cancelled
     * @return bool
     */
    public function cancelled(): bool {}

    /* Cancellation */

    /**
     * Shall try to cancel the task
     * Note: If task is running, it will be interrupted.
     * Warning: Internal function calls in progress cannot be interrupted.
     *
     * @return bool
     *
     * @throws Future\Error\Killed if \parallel\Runtime executing task was killed.
     * @throws Future\Error\Cancelled if task was already cancelled.
     */
    public function cancel(): bool {}
}