BasicSync.h

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

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

#ifndef CNTM_BASICSYNC_H
#define CNTM_BASICSYNC_H
#include <Cntm/Synchro/SynchroSpace.h>
#include <Cntm/Synchro/SynchroObject.h>

namespace Cntm
{

        /**
         * Базовый класс для синхросекций. Синхросекции автоматизируют процесс входа и выхода из синхропространства. В конструкторе синхросекций обычно производится вход, а в деструкторе - выход из синхропространства в соответствующем режиме.
         * 
         * Использование синхросекций повышает удобство (для входа/выхода требуется написать только 1 строку кода) и надежность (выход из синхропространства будет произведен в любом случае, в т.ч. и при исключении).
         * 
         * Объекты синхросекций содержат ссылочные указатели на синхрообъекты или синхропространства (IBasicSynchro), в которые произведен вход. Если синхросекция не используется для входа, то указатель на IBasicSynchro равен NULL.
         * 
         * Данный класс не поддерживает многопоточность.
         * @author Овсеевич Р.
         */
        class BasicSync
        {
        public:

                /**
                 * Возвращает указатель на синхрообъект или на синхропространство (IBasicSynchro), в которое произведен вход. Если возвращается NULL, то вход ни в какое пространство не произведен.
                 */
                IBasicSynchro::Ptr Object() const { return object; }

        protected:

                /**
                 * Установить IBasicSynchro.
                 */
                void SetObject(const IBasicSynchro::Ptr & Object) { object = Object; }

                /**
                 * Сбросить IBasicSynchro.
                 */
                void ResetObject() { object.SetNull(); }

        private:
        
                /**
                 * Указатель на IBasicSynchro, в которое произведен вход. Если NULL, то вход ни в какое пространство не произведен.
                 */
                IBasicSynchro::Ptr object;
        };

}

#endif //CNTM_BASICSYNC_H

---