phpm.ru | Класс Volatile

Введение

Класс Volatile появился в pthreads v3. Его введение является следствием новой семантики неизменности Threaded-свойств классов Threaded. Класс Volatile включает иммутабельность их Threaded-свойств и, также, используется для хранения массивов PHP в контексте Threaded.

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

Volatile extends Threaded implements Collectable , Traversable {

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

public Threaded::chunk ( int $size , bool $preserve ) : array

public Threaded::count ( ) : int

public Threaded::extend ( string $class ) : bool

public Threaded::from ( Closure $run , Closure $construct = ? , array $args = ? ) : Threaded

public Threaded::getTerminationInfo ( ) : array

public Threaded::isRunning ( ) : bool

public Threaded::isTerminated ( ) : bool

public Threaded::isWaiting ( ) : bool

public Threaded::lock ( ) : bool

public Threaded::merge ( mixed $from , bool $overwrite = ? ) : bool

public Threaded::notify ( ) : bool

public Threaded::notifyOne ( ) : bool

public Threaded::pop ( ) : bool

public Threaded::run ( ) : void

public Threaded::shift ( ) : mixed

public Threaded::synchronized ( Closure $block , mixed ...$args ) : mixed

public Threaded::unlock ( ) : bool

public Threaded::wait ( int $timeout = ? ) : bool

}

Примеры

Пример #1 Номая семантика иммутабельности Threaded


<?php

class Task extends Threaded
{
    public function __construct()
    {
        $this->data = new Threaded();

        // попытка переопределить Threaded-свойство Threaded-класса (ошибка)
        $this->data = new StdClass();
    }
}

var_dump((new Task())->data);

Результатом выполнения данного примера будет что-то подобное:

RuntimeException: Threaded members previously set to Threaded objects are immutable, cannot overwrite data in %s:%d

Пример #2 Пример использования Volatile


<?php

class Task extends Volatile
{
    public function __construct()
    {
        $this->data = new Threaded();

        // попытка переопределить Threaded-свойство Volatile-класса (корректно)
        $this->data = new StdClass();
    }
}

var_dump((new Task())->data);

Результатом выполнения данного примера будет что-то подобное:

object(stdClass)#3 (0) {
}