Класс UnderflowException

(PHP 5 >= 5.1.0, PHP 7)

Введение

Создается исключение при попытке произвести недопустимую операцию над пустым контейнером. Например такую, как удаление элемента пустого контейнера.

Обзор классов

UnderflowException extends RuntimeException {

/* Наследуемые свойства */

protected string $message ;

protected int $code ;

protected string $file ;

protected int $line ;

/* Наследуемые методы */

final public string Exception::getMessage ( void )

final public Exception Exception::getPrevious ( void )

final public mixed Exception::getCode ( void )

final public string Exception::getFile ( void )

final public int Exception::getLine ( void )

final public array Exception::getTrace ( void )

final public string Exception::getTraceAsString ( void )

public string Exception::__toString ( void )

final private void Exception::__clone ( void )

}

Коментарии

Jul 11

Автор: Jakub Adamczyk


The most typical usage is with stack, queue or collection, for example when you queue tasks, make call stack or manipulate JSON, XML, etc. elements.



As other exepctions of RuntimeException class, this type of error can't be detected in (for example) your IDE or compiler.



<?php

// Functions declared above 

$f1 = function() { setTypeControl('username');};

$f2 = function() { setTypeControl('userpass');};

$f3 = function() { setButton('Add');};

$f4 = function() { setButton('OK');};



$tasks = new class {

    private $list;



    // Create internal queue

    public function __construct() {

        $this->list = new SplQueue;

    }



    // Add to queue

    public function add(callable $func) {

        $this->list->enqueue($func);

    }



    // Delete from queue and execute

    public function do() {

        if ($this->list->isEmpty()) {

            throw new UnderflowException;

        } else {

            call_user_func($this->list->dequeue());

        }

    }



};



$tasks->add($f1);

$tasks->add($f2);

$tasks->add($f3);

$tasks->add($f4);



$tasks->do(); // Field username is created

$tasks->do(); // Field userpass is created

$tasks->do(); // Button Add is created

$tasks->do(); // Button OK is created

$tasks->do(); // Fatal error: Uncaught UnderflowException in ...