src/declarative/qml/qdeclarativeguard_p.h

   1 /****************************************************************************
   2 **
   3 ** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
   4 ** All rights reserved.
   5 ** Contact: Nokia Corporation (qt-info@nokia.com)
   6 **
   7 ** This file is part of the QtCore module of the Qt Toolkit.
   8 **
   9 ** $QT_BEGIN_LICENSE:LGPL$
  10 ** GNU Lesser General Public License Usage
  11 ** This file may be used under the terms of the GNU Lesser General Public
  12 ** License version 2.1 as published by the Free Software Foundation and
  13 ** appearing in the file LICENSE.LGPL included in the packaging of this
  14 ** file. Please review the following information to ensure the GNU Lesser
  15 ** General Public License version 2.1 requirements will be met:
  16 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
  17 **
  18 ** In addition, as a special exception, Nokia gives you certain additional
  19 ** rights. These rights are described in the Nokia Qt LGPL Exception
  20 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
  21 **
  22 ** GNU General Public License Usage
  23 ** Alternatively, this file may be used under the terms of the GNU General
  24 ** Public License version 3.0 as published by the Free Software Foundation
  25 ** and appearing in the file LICENSE.GPL included in the packaging of this
  26 ** file. Please review the following information to ensure the GNU General
  27 ** Public License version 3.0 requirements will be met:
  28 ** http://www.gnu.org/copyleft/gpl.html.
  29 **
  30 ** Other Usage
  31 ** Alternatively, this file may be used in accordance with the terms and
  32 ** conditions contained in a signed written agreement between you and Nokia.
  33 **
  34 **
  35 **
  36 **
  37 **
  38 ** $QT_END_LICENSE$
  39 **
  40 ****************************************************************************/
  41
  42 #ifndef QDECLARATIVEGUARD_P_H
  43 #define QDECLARATIVEGUARD_P_H
  44
  45 //
  46 //  W A R N I N G
  47 //  -------------
  48 //
  49 // This file is not part of the Qt API.  It exists for the convenience
  50 // of qapplication_*.cpp, qwidget*.cpp and qfiledialog.cpp.  This header
  51 // file may change from version to version without notice, or even be removed.
  52 //
  53 // We mean it.
  54 //
  55
  56 #include <QtCore/qglobal.h>
  57 #include <QtCore/qvariant.h>
  58 #include <private/qdeclarativedata_p.h>
  59
  60 QT_BEGIN_NAMESPACE
  61
  62 class QDeclarativeGuardImpl
  63 {
  64 public:
  65     inline QDeclarativeGuardImpl();
  66     inline QDeclarativeGuardImpl(QObject *);
  67     inline QDeclarativeGuardImpl(const QDeclarativeGuardImpl &);
  68     inline ~QDeclarativeGuardImpl();
  69
  70     QObject *o;
  71     QDeclarativeGuardImpl  *next;
  72     QDeclarativeGuardImpl **prev;
  73
  74     inline void addGuard();
  75     inline void remGuard();
  76 };
  77
  78 class QObject;
  79 template<class T>
  80 class QDeclarativeGuard : private QDeclarativeGuardImpl
  81 {
  82     friend class QDeclarativeData;
  83 public:
  84     inline QDeclarativeGuard();
  85     inline QDeclarativeGuard(T *);
  86     inline QDeclarativeGuard(const QDeclarativeGuard<T> &);
  87     inline virtual ~QDeclarativeGuard();
  88
  89     inline QDeclarativeGuard<T> &operator=(const QDeclarativeGuard<T> &o);
  90     inline QDeclarativeGuard<T> &operator=(T *);
  91
  92     inline T *object() const;
  93     inline void setObject(T *g);
  94
  95     inline bool isNull() const
  96         { return !o; }
  97
  98     inline T* operator->() const
  99         { return static_cast<T*>(const_cast<QObject*>(o)); }
 100     inline T& operator*() const
 101         { return *static_cast<T*>(const_cast<QObject*>(o)); }
 102     inline operator T*() const
 103         { return static_cast<T*>(const_cast<QObject*>(o)); }
 104     inline T* data() const
 105         { return static_cast<T*>(const_cast<QObject*>(o)); }
 106
 107 protected:
 108     virtual void objectDestroyed(T *) {}
 109 };
 110
 111 Q_DECLARE_METATYPE(QDeclarativeGuard<QObject>)
 112
 113 QDeclarativeGuardImpl::QDeclarativeGuardImpl()
 114 : o(0), next(0), prev(0)
 115 {
 116 }
 117
 118 QDeclarativeGuardImpl::QDeclarativeGuardImpl(QObject *g)
 119 : o(g), next(0), prev(0)
 120 {
 121     if (o) addGuard();
 122 }
 123
 124 QDeclarativeGuardImpl::QDeclarativeGuardImpl(const QDeclarativeGuardImpl &g)
 125 : o(g.o), next(0), prev(0)
 126 {
 127     if (o) addGuard();
 128 }
 129
 130 QDeclarativeGuardImpl::~QDeclarativeGuardImpl()
 131 {
 132     if (prev) remGuard();
 133     o = 0;
 134 }
 135
 136 void QDeclarativeGuardImpl::addGuard()
 137 {
 138     Q_ASSERT(!prev);
 139
 140     if (QObjectPrivate::get(o)->wasDeleted)
 141         return;
 142
 143     QDeclarativeData *data = QDeclarativeData::get(o, true);
 144     next = data->guards;
 145     if (next) next->prev = &next;
 146     data->guards = this;
 147     prev = &data->guards;
 148 }
 149
 150 void QDeclarativeGuardImpl::remGuard()
 151 {
 152     Q_ASSERT(prev);
 153
 154     if (next) next->prev = prev;
 155     *prev = next;
 156     next = 0;
 157     prev = 0;
 158 }
 159
 160 template<class T>
 161 QDeclarativeGuard<T>::QDeclarativeGuard()
 162 {
 163 }
 164
 165 template<class T>
 166 QDeclarativeGuard<T>::QDeclarativeGuard(T *g)
 167 : QDeclarativeGuardImpl(g)
 168 {
 169 }
 170
 171 template<class T>
 172 QDeclarativeGuard<T>::QDeclarativeGuard(const QDeclarativeGuard<T> &g)
 173 : QDeclarativeGuardImpl(g)
 174 {
 175 }
 176
 177 template<class T>
 178 QDeclarativeGuard<T>::~QDeclarativeGuard()
 179 {
 180 }
 181
 182 template<class T>
 183 QDeclarativeGuard<T> &QDeclarativeGuard<T>::operator=(const QDeclarativeGuard<T> &g)
 184 {
 185     setObject(g.object());
 186     return *this;
 187 }
 188
 189 template<class T>
 190 QDeclarativeGuard<T> &QDeclarativeGuard<T>::operator=(T *g)
 191 {
 192     setObject(g);
 193     return *this;
 194 }
 195
 196 template<class T>
 197 T *QDeclarativeGuard<T>::object() const
 198 {
 199     return static_cast<T *>(o);
 200 };
 201
 202 template<class T>
 203 void QDeclarativeGuard<T>::setObject(T *g)
 204 {
 205     if (g != o) {
 206         if (prev) remGuard();
 207         o = g;
 208         if (o) addGuard();
 209     }
 210 }
 211
 212 QT_END_NAMESPACE
 213
 214 #endif // QDECLARATIVEGUARD_P_H