BasicGenericRefPtr.h

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

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

#ifndef CNTM_BASICGENERICREFPTR_H
#define CNTM_BASICGENERICREFPTR_H
#include <Cntm/RefCount/RefPtr.h>
#include <Cntm/RefCount/Internal/GenericRefPtrImpl.h>

namespace Cntm
{

        namespace SpecUtils {}
        
        /**
         * Базовый класс для классов GenericRefPtr и GenericNoRefPtr (см. эти классы). Содержит основные операции для работы с обобщенными указателями.
         * 
         * Данный класс не обеспечивает полную многопоточность. Операция присвоения нового значения требует внешней синхронизации.
         */
        class BasicGenericRefPtr
        {
        private:
                
                /**
                 * Класс для управления NULL - значениями.
                 */
                class NullGenericRefPtrImpl : public SpecUtils::GenericRefPtrImpl
                {
                public:
                        
                        void InitRefPtr(void** PtrPtr) {}
                        
                        void DeinitRefPtr(void** PtrPtr) {}
                        
                        void* CastPtrTo(void* Ptr, const std::type_info& TypeInfo) { return NULL; }
                };
                
        public:

                /**
                 * Конструктор по умолчанию. Инициализирует указатель  NULL. 
                 */
                BasicGenericRefPtr()
                {
                        SetNull();
                }

                /**
                 * Конструктор инициализации из ссылочного указателя. 
                 */
                template < typename T >
                BasicGenericRefPtr(RefPtr < T > Src)
                {
                        SetPointer(Src.Pointer());
                }

                /**
                 * Конструктор инициализации из обычного указателя. 
                 */
                template < typename T >
                BasicGenericRefPtr(T* Src)
                {
                        SetPointer(Src);
                }

                /**
                 * Конструктор копирования. 
                 */
                BasicGenericRefPtr(const BasicGenericRefPtr& Src)
                {
                        genImpl = Src.genImpl;
                        pointer = Src.pointer;
                }

                /**
                 * Оператор присвоения ссылочного указателя. 
                 */
                template < typename T >
                BasicGenericRefPtr& operator = (RefPtr < T > Src)
                {
                        SetPointer(Src.Pointer());
                        return *this;
                }

                /**
                 * Оператор присвоения обычного указателя. 
                 */
                template < typename T >
                BasicGenericRefPtr& operator = (T* Src)
                {
                        SetPointer(Src);
                        return *this;
                }

                /**
                 * Оператор присвоения. 
                 */
                BasicGenericRefPtr& operator = (const BasicGenericRefPtr& Src)
                {
                        genImpl = Src.genImpl;
                        pointer = Src.pointer;
                        return *this;
                }

                /**
                 * Приведение к типу bool. true - если указатель не равен NULL, иначе false.
                 */
                operator bool () const
                {
                        return pointer != NULL;
                }

                /**
                 * Оператор not. Противоположен operator bool().
                 */
                bool operator ! () const
                {
                        return pointer == NULL;
                }

                /**
                 * Оператор сравнения на равенство. Использует ссылочный указатель.
                 */
                template < typename T >
                bool operator == (const RefPtr < T > & Ptr) const
                {
                        return pointer == Ptr.Pointer();
                }

                /**
                 * Оператор сравнения на равенство. Использует указатель на объект.
                 */
                template < typename T >
                bool operator == (T* Ptr) const
                {
                        return pointer == Ptr;
                }

                /**
                 * Оператор сравнения на равенство. Использует ссылку на обобщенный указатель.
                 */
                bool operator == (const BasicGenericRefPtr& Src) const
                {
                        return pointer == Src.Pointer();
                }

                /**
                 * Оператор сравнения на не равенство. Использует ссылочный указатель.
                 */
                template < typename T >
                bool operator != (const RefPtr < T > & Ptr) const
                {
                        return pointer == Ptr.Pointer();
                }

                /**
                 * Оператор сравнения на не равенство. Использует указатель на объект.
                 */
                template < typename T >
                bool operator != (T* Ptr) const
                {
                        return pointer == Ptr;
                }

                /**
                 * Оператор сравнения на не равенство. Использует ссылку на обобщенный указатель.
                 */
                bool operator != (const BasicGenericRefPtr& Src) const
                {
                        return pointer == Src.Pointer();
                }

                /**
                 * Получить нетипизированный указатель на объект.
                 */
                void* Pointer() const
                {
                        return pointer;
                }

                /**
                 * Пытается преобразовать указатель к указанному в шаблоне типу. Поддерживается ограниченный набор классов, к которым может выполниться приведение. Эти классы перечислены в описаниях методов CastPtrTo() классов, унаследовавших Cntm::SpecUtils::GenericRefPtrImpl.
                 * 
                 * Этот метод является служебным. 
                 */
                template < typename BaseT >
                BaseT* DynamicCast()
                {
                        return reinterpret_cast<BaseT*>(genImpl->CastPtrTo(pointer, typeid(BaseT)));
                }

                /**
                 * Сбросить указатель в NULL. 
                 */
                void SetNull()
                {
                        static NullGenericRefPtrImpl nullGenericRefPtrImpl;
                        genImpl = &nullGenericRefPtrImpl;
                        pointer = NULL;
                }

        protected:

                /**
                 * Возвращает указатель на объект, который выполняет манипуляции с нетипизированным указателем на объект с подсчетом ссылок. 
                 */
                SpecUtils::GenericRefPtrImpl* GenImpl() const
                {
                        return genImpl;
                }

                /**
                 * Возвращает указатель на указатель для записи нового значения. 
                 */
                void** PtrPointer() { return &pointer; }
                
                /**
                 * Шаблонный метод, устанавливающий указатель и выбирающий объект, выполняющий манипуляции с указателем исходя из типа класса указателя. 
                 */
                template < typename T >
                void SetPointer(T* Src)
                {
                        using namespace SpecUtils;
                        genImpl = GetGenericRefPtrImpl(Src, Src);
                        pointer = Src;
                }

        private:
                
                /**
                 * Указатель на объект, который выполняет манипуляции с нетипизированным указателем на объект с подсчетом ссылок. Данный объект знает, как преобразовать указатель void* к истинному типу объекта, как увеличивать и уменьшать кол-во ссылок. По сути дела используется для задания информации о типе объекта. 
                 */
                SpecUtils::GenericRefPtrImpl* genImpl;
                
                /**
                 * Нетипизированный указатель на объект. 
                 */
                void* pointer;
        };

}

#endif //CNTM_BASICGENERICREFPTR_H

---