ILIAS\Data\Result\Error Class Reference

A result encapsulates a value or an error and simplifies the handling of those. More...

Inheritance diagram for ILIAS\Data\Result\Error:

Collaboration diagram for ILIAS\Data\Result\Error:

Public Member Functions
	__construct ($error)
	isOK ()
	Get to know if the result is ok. More...
	value ()
	Get the encapsulated value. Returns mixed Exceptions More...
	isError ()
	Get to know if the result is an error. More...
	error ()
	Get the encapsulated error. Returns |string Exceptions More...
	valueOr ($default)
	Get the encapsulated value or the supplied default if result is an error. Parameters mixed $default Returns mixed More...
	map (callable $f)
	Create a new result where the contained value is modified with $f.Does nothing if !isOK. Parameters callable $f mixed -> mixed More...
	then (callable $f)
	Get a new result from the callable or do nothing if this is an error.If null is returned from $f, the result is not touched.Does nothing if !isOK. This is monadic bind. Parameters callable $f mixed -> Result|null Exceptions More...
	except (callable $f)
	Feed the error into a callable and replace this with the result or do nothing if this is a value.If null is returned from $f, the error in the result is not touched.Does nothing if !isError. Parameters callable $f string| -> Result|null Exceptions More...

Protected Attributes
	$error

Detailed Description

A result encapsulates a value or an error and simplifies the handling of those.

Author

Stefan Hecken stefa.nosp@m.n.he.nosp@m.cken@.nosp@m.conc.nosp@m.epts-.nosp@m.and-.nosp@m.train.nosp@m.ing..nosp@m.de

Definition at line 17 of file Error.php.

Constructor & Destructor Documentation

__construct()

ILIAS\Data\Result\Error::__construct

(

$error

)

Definition at line 24 of file Error.php.

References ILIAS\Data\Result\Error\$error, and ILIAS\Data\Result\Error\error().

    {
        if (!is_string($error) && !($error instanceof \Exception)) {
            throw new \InvalidArgumentException("Expected error to be a string or an Exception.");
        }
        $this->error = $error;
    }

Here is the call graph for this function:

Member Function Documentation

error()

ILIAS\Data\Result\Error::error

(

)

Get the encapsulated error.

Returns

|string

Exceptions

Implements ILIAS\Data\Result.

Definition at line 63 of file Error.php.

References ILIAS\Data\Result\Error\$error.

Referenced by ILIAS\Data\Result\Error\__construct(), ILIAS\Data\Result\Error\except(), and ILIAS\Data\Result\Error\value().

    {
        return $this->error;
    }

Here is the caller graph for this function:

except()

ILIAS\Data\Result\Error::except

(

callable

$f

)

Feed the error into a callable and replace this with the result or do nothing if this is a value.If null is returned from $f, the error in the result is not touched.Does nothing if !isError.

Parameters

callable

$f

string| -> Result|null

Exceptions

Implements ILIAS\Data\Result.

Definition at line 95 of file Error.php.

References Vendor\Package\$f, and ILIAS\Data\Result\Error\error().

                                       : Result
    {
        $result = $f($this->error);

        if ($result === null) {
            return $this;
        }

        if (!$result instanceof Data\Result) {
            throw new \UnexpectedValueException("The returned type of callable is not an instance of interface Result");
        }

        return $result;
    }

Here is the call graph for this function:

isError()

ILIAS\Data\Result\Error::isError

(

)

Get to know if the result is an error.

Implements ILIAS\Data\Result.

Definition at line 55 of file Error.php.

                             : bool
    {
        return true;
    }

isOK()

ILIAS\Data\Result\Error::isOK

(

)

Get to know if the result is ok.

Implements ILIAS\Data\Result.

Definition at line 35 of file Error.php.

                          : bool
    {
        return false;
    }

map()

ILIAS\Data\Result\Error::map

(

callable

$f

)

Create a new result where the contained value is modified with $f.Does nothing if !isOK.

Parameters

callable

$f

mixed -> mixed

Implements ILIAS\Data\Result.

Definition at line 79 of file Error.php.

                                    : Result
    {
        return $this;
    }

then()

ILIAS\Data\Result\Error::then

(

callable

$f

)

Get a new result from the callable or do nothing if this is an error.If null is returned from $f, the result is not touched.Does nothing if !isOK. This is monadic bind.

Parameters

callable

$f

mixed -> Result|null

Exceptions

Implements ILIAS\Data\Result.

Definition at line 87 of file Error.php.

                                     : Result
    {
        return $this;
    }

value()

ILIAS\Data\Result\Error::value

(

)

Get the encapsulated value.

Returns

mixed

Exceptions

Implements ILIAS\Data\Result.

Definition at line 43 of file Error.php.

References ILIAS\Data\Result\Error\$error, and ILIAS\Data\Result\Error\error().

    {
        if ($this->error instanceof \Exception) {
            throw $this->error;
        }

        throw new Data\NotOKException($this->error);
    }

Here is the call graph for this function:

valueOr()

ILIAS\Data\Result\Error::valueOr

(

$default

)

Get the encapsulated value or the supplied default if result is an error.

Parameters

mixed

$default

Returns

mixed

Implements ILIAS\Data\Result.

Definition at line 71 of file Error.php.

    {
        return $default;
    }

Field Documentation

$error

ILIAS\Data\Result\Error::$error

protected

Definition at line 22 of file Error.php.

Referenced by ILIAS\Data\Result\Error\__construct(), ILIAS\Data\Result\Error\error(), and ILIAS\Data\Result\Error\value().

---

The documentation for this class was generated from the following file:

• components/ILIAS/Data/src/Result/Error.php