Using.h

См. документацию.

/*
 * CntmLib - Подсчет ссылок, потоки, синхронизация, асинхронные процедуры, события
 * Copyright (c) 2005, Овсеевич Роман, CntmLib@mail.ru
 * _______________________________________________________________________________
 * Разрешено свободное использование, копирование, распространение, изменение
 * (изменение сведений об авторских правах запрещено). Запрещена продажа и
 * включение всей библиотеки или ее частей в другие библиотеки. В сведениях об
 * авторских правах на программу (или сведениях о программе, об авторах,
 * использованных средствах разработки и т.д.) должна быть указана информация
 * о библиотеке CntmLib, ее авторе и, возможно, сайте или email'е.
 * Библиотека поставляется "как есть", без каких-либо гарантий со стороны автора.
 */

#ifndef CNTM_USING_H
#define CNTM_USING_H
#include <Cntm/Concurrency/ExecutionUnit.h>
#include <Cntm/Concurrency/TerminatingSignal.h>
#include <Cntm/RefCount/IRefObject.h>

namespace Cntm
{

        /**
         * Объекты данного класса используются как scoped-объекты, наподобии auto_ptr и т.п., и являются по сути ссылочными указателями на объекты. Using-объекты преследуют 2 цели: 1 - при создании они проверяют флаг завершения потока и переданный ссылочный указатель на NULL (т.е. объект уже находится в удаляемом состоянии), если какое либо из этих условий истинно, то генерируется специальное исключение Cntm::TerminatingSignal. 2 цель - хранить полученный ссылочный на время существования Using-объекта, т.о. гарантируется, что при выполнении кода, находящегося между созданием и деинициализацией Using-объекта объект не перейдет в удаляемое состояние.
         * 
         * Пример использования.
         * Using use(*this); // Вход в Using-секцию. Либо вход будет успешный, либо, если поток необходимо завершить, то будет сгенерировано исключение TerminatingSignal.
         * ... // В этом блоке объект всегда находится не в удаляемом состоянии и преобразование обычного указателя (например, this) к ссылочному никогда не приведет к результату NULL.
         * use.Unuse(); // Выход из блока.
         * 
         * Использование Using-объектов целесообразно там, где единица выполнения не хранит ссылку на объект, метод которого выполняет, т.е. использовать их следует в потоках активных объектов и асинхронных процедурах, если они не хранят ссылочный указатель на объект.
         * 
         * Класс не поддерживает многопоточность.
         * @author Овсеевич Р.
         * \ingroup Concurrency
         */
        class Using: public IRefObject::Ptr
        {
        public:

                /**
                 * Конструктор инициализации ссылочным указателем или ссылкой (которая м.б. преобразована к ссылочному указателю) на объект. Сохраняет полученный ссылочный указатель.
                 * 
                 * Исключение: TerminatingSignal - если установлен флаг Terminated() текущей единицы выполнения или объект находится в удаляемом состоянии (ссылочный указатель на него равен NULL).
                 * @param Object - сылочный указатель или ссылка на объект, который будет использоваться в этой секции.
                 */
                Using(const IRefObject::Ptr& Object): IRefObject::Ptr(Object)
                {
                        ExecutionUnit::CheckTerminating();
                        if (!*this) throw TerminatingSignal();
                }

                /**
                 * Конструктор копирования. Сохраняет ссылочный указатель из источника.
                 * 
                 * Исключение: TerminatingSignal - если установлен флаг Terminated() текущей единицы выполнения или объект находится в удаляемом состоянии (ссылочный указатель на него равен NULL).
                 * @param Src - секция-источник.
                 */
                Using(const Using& Src): IRefObject::Ptr(Src)
                {
                        ExecutionUnit::CheckTerminating();
                        if (!*this) throw TerminatingSignal();
                }

                /**
                 * Оператор присвоения ссылочного указателя или обычной ссылки (которая м.б. преобразована к ссылочному указателю) на объект. Сохраняет полученный ссылочный указатель.
                 * 
                 * Исключение: TerminatingSignal - если установлен флаг Terminated() текущей единицы выполнения или объект находится в удаляемом состоянии (ссылочный указатель на него равен NULL).
                 * @param Object - сылочный указатель или ссылка на объект, который будет использоваться в этой секции.
                 */
                Using& operator = (const IRefObject::Ptr& Object)
                {
                        ExecutionUnit::CheckTerminating();
                        IRefObject::Ptr::operator = (Object);
                        if (!*this) throw TerminatingSignal();
                        return *this;
                }

                /**
                 * Оператор присвоения. Сохраняет ссылочный указатель из источника.
                 * 
                 * Исключение: TerminatingSignal - если установлен флаг Terminated() текущей единицы выполнения или объект находится в удаляемом состоянии (ссылочный указатель на него равен NULL).
                 * @param Src - секция-источник.
                 */
                Using& operator = (const Using& Src)
                {
                        ExecutionUnit::CheckTerminating();
                        IRefObject::Ptr::operator = (Src);
                        if (!*this) throw TerminatingSignal();
                        return *this;
                }

                /**
                 * Досрочный выход из Using-секции. Сбрасывает в NULL значение хранящегося ссылочного указателя.
                 */
                void Unuse() { SetNull(); }
        };

}

#endif //CNTM_USING_H

---