src/declarative/qml/qdeclarativeguard_p.h

   1 /****************************************************************************
   2 **
   3 ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
   4 ** All rights reserved.
   5 ** Contact: http://www.qt-project.org/
   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 QT_END_NAMESPACE
 112
 113 Q_DECLARE_METATYPE(QDeclarativeGuard<QObject>)
 114
 115 QT_BEGIN_NAMESPACE
 116
 117 QDeclarativeGuardImpl::QDeclarativeGuardImpl()
 118 : o(0), next(0), prev(0)
 119 {
 120 }
 121
 122 QDeclarativeGuardImpl::QDeclarativeGuardImpl(QObject *g)
 123 : o(g), next(0), prev(0)
 124 {
 125     if (o) addGuard();
 126 }
 127
 128 QDeclarativeGuardImpl::QDeclarativeGuardImpl(const QDeclarativeGuardImpl &g)
 129 : o(g.o), next(0), prev(0)
 130 {
 131     if (o) addGuard();
 132 }
 133
 134 QDeclarativeGuardImpl::~QDeclarativeGuardImpl()
 135 {
 136     if (prev) remGuard();
 137     o = 0;
 138 }
 139
 140 void QDeclarativeGuardImpl::addGuard()
 141 {
 142     Q_ASSERT(!prev);
 143
 144     if (QObjectPrivate::get(o)->wasDeleted)
 145         return;
 146
 147     QDeclarativeData *data = QDeclarativeData::get(o, true);
 148     next = data->guards;
 149     if (next) next->prev = &next;
 150     data->guards = this;
 151     prev = &data->guards;
 152 }
 153
 154 void QDeclarativeGuardImpl::remGuard()
 155 {
 156     Q_ASSERT(prev);
 157
 158     if (next) next->prev = prev;
 159     *prev = next;
 160     next = 0;
 161     prev = 0;
 162 }
 163
 164 template<class T>
 165 QDeclarativeGuard<T>::QDeclarativeGuard()
 166 {
 167 }
 168
 169 template<class T>
 170 QDeclarativeGuard<T>::QDeclarativeGuard(T *g)
 171 : QDeclarativeGuardImpl(g)
 172 {
 173 }
 174
 175 template<class T>
 176 QDeclarativeGuard<T>::QDeclarativeGuard(const QDeclarativeGuard<T> &g)
 177 : QDeclarativeGuardImpl(g)
 178 {
 179 }
 180
 181 template<class T>
 182 QDeclarativeGuard<T>::~QDeclarativeGuard()
 183 {
 184 }
 185
 186 template<class T>
 187 QDeclarativeGuard<T> &QDeclarativeGuard<T>::operator=(const QDeclarativeGuard<T> &g)
 188 {
 189     setObject(g.object());
 190     return *this;
 191 }
 192
 193 template<class T>
 194 QDeclarativeGuard<T> &QDeclarativeGuard<T>::operator=(T *g)
 195 {
 196     setObject(g);
 197     return *this;
 198 }
 199
 200 template<class T>
 201 T *QDeclarativeGuard<T>::object() const
 202 {
 203     return static_cast<T *>(o);
 204 };
 205
 206 template<class T>
 207 void QDeclarativeGuard<T>::setObject(T *g)
 208 {
 209     if (g != o) {
 210         if (prev) remGuard();
 211         o = g;
 212         if (o) addGuard();
 213     }
 214 }
 215
 216 QT_END_NAMESPACE
 217
 218 #endif // QDECLARATIVEGUARD_P_H