- Main Page
- Related Pages
- Modules
- Namespaces
- Classes
- Files
- Directories
- Examples

- File List
- File Members

# qsharedpointer.h

Go to the documentation of this file.

    00001 /****************************************************************************
    00002 **
    00003 ** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
    00004 ** All rights reserved.
    00005 ** Contact: Nokia Corporation (qt-info@nokia.com)
    00006 **
    00007 ** This file is part of the QtCore module of the Qt Toolkit.
    00008 **
    00009 ** $QT_BEGIN_LICENSE:LGPL$
    00010 ** Commercial Usage
    00011 ** Licensees holding valid Qt Commercial licenses may use this file in
    00012 ** accordance with the Qt Commercial License Agreement provided with the
    00013 ** Software or, alternatively, in accordance with the terms contained in
    00014 ** a written agreement between you and Nokia.
    00015 **
    00016 ** GNU Lesser General Public License Usage
    00017 ** Alternatively, this file may be used under the terms of the GNU Lesser
    00018 ** General Public License version 2.1 as published by the Free Software
    00019 ** Foundation and appearing in the file LICENSE.LGPL included in the
    00020 ** packaging of this file.  Please review the following information to
    00021 ** ensure the GNU Lesser General Public License version 2.1 requirements
    00022 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
    00023 **
    00024 ** In addition, as a special exception, Nokia gives you certain additional
    00025 ** rights.  These rights are described in the Nokia Qt LGPL Exception
    00026 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this module.
    00027 **
    00028 ** GNU General Public License Usage
    00029 ** Alternatively, this file may be used under the terms of the GNU
    00030 ** General Public License version 3.0 as published by the Free Software
    00031 ** Foundation and appearing in the file LICENSE.GPL included in the
    00032 ** packaging of this file.  Please review the following information to
    00033 ** ensure the GNU General Public License version 3.0 requirements will be
    00034 ** met: http://www.gnu.org/copyleft/gpl.html.
    00035 **
    00036 ** If you have questions regarding the use of this file, please contact
    00037 ** Nokia at qt-info@nokia.com.
    00038 ** $QT_END_LICENSE$
    00039 **
    00040 ****************************************************************************/
    00041
    00042 #ifndef QSHAREDPOINTER_H
    00043 #define QSHAREDPOINTER_H
    00044
    00045 #include <QtCore/qglobal.h>
    00046 #include <QtCore/qatomic.h>
    00047 #include <QtCore/qshareddata.h>
    00048
    00049 #ifndef Q_QDOC
    00050 # if !defined(QT_NO_MEMBER_TEMPLATES)
    00051 // QSharedPointer requires member template support
    00052 # include <QtCore/qsharedpointer_impl.h>
    00053 # endif
    00054 #else
    00055
    00056 QT_BEGIN_HEADER
    00057
    00058 QT_BEGIN_NAMESPACE
    00059
    00060 QT_MODULE(Core)
    00061
    00062 // These classes are here to fool qdoc into generating a better documentation
    00063
    00064 template <class T>
    00065 class QSharedPointer
    00066 {
    00067 public:
    00068     // basic accessor functions
    00069     T *data() const;
    00070     bool isNull() const;
    00071     operator bool() const;
    00072     bool operator!() const;
    00073     T &operator*() const;
    00074     T *operator ->() const;
    00075
    00076     // constructors
    00077     QSharedPointer();
    00078     explicit QSharedPointer(T *ptr);
    00079     QSharedPointer(T *ptr, Deleter d);
    00080     QSharedPointer(const QSharedPointer<T> &other);
    00081     QSharedPointer(const QWeakPointer<T> &other);
    00082
    00083     ~QSharedPointer() { }
    00084
    00085     QSharedPointer<T> &operator=(const QSharedPointer<T> &other);
    00086     QSharedPointer<T> &operator=(const QWeakPointer<T> &other);
    00087
    00088     QWeakPointer<T> toWeakRef() const;
    00089
    00090     void clear();
    00091
    00092     // casts:
    00093     template <class X> QSharedPointer<X> staticCast() const;
    00094     template <class X> QSharedPointer<X> dynamicCast() const;
    00095     template <class X> QSharedPointer<X> constCast() const;
    00096     template <class X> QSharedPointer<X> objectCast() const;
    00097 };
    00098
    00099 template <class T>
    00100 class QWeakPointer
    00101 {
    00102 public:
    00103     // basic accessor functions
    00104     bool isNull() const;
    00105     operator bool() const;
    00106     bool operator!() const;
    00107
    00108     // constructors:
    00109     QWeakPointer();
    00110     QWeakPointer(const QWeakPointer<T> &other);
    00111     QWeakPointer(const QSharedPointer<T> &other);
    00112
    00113     ~QWeakPointer();
    00114
    00115     QWeakPointer<T> operator=(const QWeakPointer<T> &other);
    00116     QWeakPointer<T> operator=(const QSharedPointer<T> &other);
    00117
    00118     QWeakPointer(const QObject *other);
    00119     QWeakPointer<T> operator=(const QObject *other);
    00120
    00121     T *data() const;
    00122     void clear();
    00123
    00124     QSharedPointer<T> toStrongRef() const;
    00125 };
    00126
    00127 template<class T, class X> bool operator==(const QSharedPointer<T> &ptr1, const QSharedPointer<X> &ptr2);
    00128 template<class T, class X> bool operator!=(const QSharedPointer<T> &ptr1, const QSharedPointer<X> &ptr2);
    00129 template<class T, class X> bool operator==(const QSharedPointer<T> &ptr1, const X *ptr2);
    00130 template<class T, class X> bool operator!=(const QSharedPointer<T> &ptr1, const X *ptr2);
    00131 template<class T, class X> bool operator==(const T *ptr1, const QSharedPointer<X> &ptr2);
    00132 template<class T, class X> bool operator!=(const T *ptr1, const QSharedPointer<X> &ptr2);
    00133 template<class T, class X> bool operator==(const QWeakPointer<T> &ptr1, const QSharedPointer<X> &ptr2);
    00134 template<class T, class X> bool operator!=(const QWeakPointer<T> &ptr1, const QSharedPointer<X> &ptr2);
    00135 template<class T, class X> bool operator==(const QSharedPointer<T> &ptr1, const QWeakPointer<X> &ptr2);
    00136 template<class T, class X> bool operator!=(const QSharedPointer<T> &ptr1, const QWeakPointer<X> &ptr2);
    00137
    00138 template <class X, class T> QSharedPointer<X> qSharedPointerCast(const QSharedPointer<T> &other);
    00139 template <class X, class T> QSharedPointer<X> qSharedPointerCast(const QWeakPointer<T> &other);
    00140 template <class X, class T> QSharedPointer<X> qSharedPointerDynamicCast(const QSharedPointer<T> &src);
    00141 template <class X, class T> QSharedPointer<X> qSharedPointerDynamicCast(const QWeakPointer<T> &src);
    00142 template <class X, class T> QSharedPointer<X> qSharedPointerConstCast(const QSharedPointer<T> &src);
    00143 template <class X, class T> QSharedPointer<X> qSharedPointerConstCast(const QWeakPointer<T> &src);
    00144 template <class X, class T> QSharedPointer<X> qSharedPointerObjectCast(const QSharedPointer<T> &src);
    00145 template <class X, class T> QSharedPointer<X> qSharedPointerObjectCast(const QWeakPointer<T> &src);
    00146
    00147 template <class X, class T> QWeakPointer<X> qWeakPointerCast(const QWeakPointer<T> &src);
    00148
    00149 QT_END_NAMESPACE
    00150
    00151 QT_END_HEADER
    00152
    00153 #endif // Q_QDOC
    00154
    00155 #endif // QSHAREDPOINTER_H