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. Returns bool More...
	value ()
	Get the encapsulated value. Exceptions Exception if !isOK, will either throw the contained exception or a NotOKException if a string is contained as error. Returns mixed More...
	isError ()
	Get to know if the result is an error. Returns bool More...
	error ()
	Get the encapsulated error. Exceptions LogicException if isOK Returns Exception|string More...
	valueOr ($default)
	Get the encapsulated value or the supplied default if result is an error. Parameters 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 Returns Result 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 UnexpectedValueException If callable returns no instance of Result Returns Result 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 UnexpectedValueException If callable returns no instance of Result Returns Result 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 13 of file Error.php.

Constructor & Destructor Documentation

__construct()

ILIAS\Data\Result\Error::__construct

(

$error

)

Definition at line 21 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.

Exceptions

LogicException

if isOK

Returns

Exception|string

Implements ILIAS\Data\Result.

Definition at line 59 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

UnexpectedValueException

If callable returns no instance of Result

Returns

Result

Implements ILIAS\Data\Result.

Definition at line 91 of file Error.php.

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

    {
        $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.

Returns

bool

Implements ILIAS\Data\Result.

Definition at line 51 of file Error.php.

    {
        return true;
    }

isOK()

ILIAS\Data\Result\Error::isOK

(

)

Get to know if the result is ok.

Returns

bool

Implements ILIAS\Data\Result.

Definition at line 31 of file Error.php.

    {
        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

Returns

Result

Implements ILIAS\Data\Result.

Definition at line 75 of file Error.php.

    {
        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

UnexpectedValueException

If callable returns no instance of Result

Returns

Result

Implements ILIAS\Data\Result.

Definition at line 83 of file Error.php.

    {
        return $this;
    }

value()

ILIAS\Data\Result\Error::value

(

)

Get the encapsulated value.

Exceptions

Exception

if !isOK, will either throw the contained exception or a NotOKException if a string is contained as error.

Returns

mixed

Implements ILIAS\Data\Result.

Definition at line 39 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

default

Returns

mixed

Implements ILIAS\Data\Result.

Definition at line 67 of file Error.php.

References $default.

    {
        return $default;
    }

Field Documentation

$error

ILIAS\Data\Result\Error::$error

protected

Definition at line 19 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:

• src/Data/Result/Error.php