chippyash/Monad

<?php
/**
 * Monad
 *
 * @author Ashley Kitson
 * @copyright Ashley Kitson, 2015, UK
 * @license GPL V3+ See LICENSE.md
 */
declare(strict_types=1);
namespace Monad\FTry;

use Monad\FTry;

class Failure extends FTry
{
    /**
     * Constructor
     * @param \Exception $value
     */
    public function __construct(\Exception $value)
    {
        $this->value = $value;
    }

    /**
     * Always return another instance of Failure
     *
     * @param \Exception $value Ignored
     *
     * @return Failure
     */
    public static function create($value = null): Failure
    {
        if ($value instanceof \Exception) {
            return new static($value);
        }

        return new static(new \RuntimeException('Creating Failure with no exception'));
    }

    /**
     * Always return another instance of failure
     *
     * @param \Closure $function Ignored
     * @param array $args Ignored
     *
     * @return Failure
     */
    public function bind(\Closure $function, array $args = []): Failure
    {
        return new static($this->value);
    }

    /**
     * Throw this failure as a php exception
     * We use 'pass' as `throw` is a PHP reserved word and I'm a Rugby player
     *
     * @throw \Exception
     */
    public function pass()
    {
        throw $this->value;
    }

    /**
     * Is this option a Success?
     *
     * @return bool
     */
    public function isSuccess(): bool
    {
        return false;
    }
}