qfuture.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:9k
- /****************************************************************************
- **
- ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
- ** Contact: Qt Software Information (qt-info@nokia.com)
- **
- ** This file is part of the QtCore module of the Qt Toolkit.
- **
- ** Commercial Usage
- ** Licensees holding valid Qt Commercial licenses may use this file in
- ** accordance with the Qt Commercial License Agreement provided with the
- ** Software or, alternatively, in accordance with the terms contained in
- ** a written agreement between you and Nokia.
- **
- **
- ** GNU General Public License Usage
- ** Alternatively, this file may be used under the terms of the GNU
- ** General Public License versions 2.0 or 3.0 as published by the Free
- ** Software Foundation and appearing in the file LICENSE.GPL included in
- ** the packaging of this file. Please review the following information
- ** to ensure GNU General Public Licensing requirements will be met:
- ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
- ** http://www.gnu.org/copyleft/gpl.html. In addition, as a special
- ** exception, Nokia gives you certain additional rights. These rights
- ** are described in the Nokia Qt GPL Exception version 1.3, included in
- ** the file GPL_EXCEPTION.txt in this package.
- **
- ** Qt for Windows(R) Licensees
- ** As a special exception, Nokia, as the sole copyright holder for Qt
- ** Designer, grants users of the Qt/Eclipse Integration plug-in the
- ** right for the Qt/Eclipse Integration to link to functionality
- ** provided by Qt Designer and its related libraries.
- **
- ** If you are unsure which license is appropriate for your use, please
- ** contact the sales department at qt-sales@nokia.com.
- **
- ****************************************************************************/
- #ifndef QFUTURE_H
- #define QFUTURE_H
- #include <QtCore/qglobal.h>
- #ifndef QT_NO_QFUTURE
- #include <QtCore/qfutureinterface.h>
- #include <QtCore/qstring.h>
- #include <QtCore/qtconcurrentcompilertest.h>
- QT_BEGIN_HEADER
- QT_BEGIN_NAMESPACE
- QT_MODULE(Core)
- template <typename T>
- class QFutureWatcher;
- template <>
- class QFutureWatcher<void>;
- template <typename T>
- class QFuture
- {
- public:
- QFuture()
- : d(QFutureInterface<T>::canceledResult())
- { }
- explicit QFuture(QFutureInterface<T> *p) // internal
- : d(*p)
- { }
- QFuture(const QFuture &other)
- : d(other.d)
- { }
- ~QFuture()
- { }
- inline QFuture &operator=(const QFuture &other);
- bool operator==(const QFuture &other) const { return (d == other.d); }
- bool operator!=(const QFuture &other) const { return (d != other.d); }
- void cancel() { d.cancel(); }
- bool isCanceled() const { return d.isCanceled(); }
- void setPaused(bool paused) { d.setPaused(paused); }
- bool isPaused() const { return d.isPaused(); }
- void pause() { setPaused(true); }
- void resume() { setPaused(false); }
- void togglePaused() { d.togglePaused(); }
- bool isStarted() const { return d.isStarted(); }
- bool isFinished() const { return d.isFinished(); }
- bool isRunning() const { return d.isRunning(); }
- int resultCount() const { return d.resultCount(); }
- int progressValue() const { return d.progressValue(); }
- int progressMinimum() const { return d.progressMinimum(); }
- int progressMaximum() const { return d.progressMaximum(); }
- QString progressText() const { return d.progressText(); }
- void waitForFinished() { d.waitForFinished(); }
- inline T result() const;
- inline T resultAt(int index) const;
- bool isResultReadyAt(int index) const { return d.isResultReadyAt(index); }
- operator T() const { return result(); }
- QList<T> results() const { return d.results(); }
- class const_iterator
- {
- public:
- typedef std::bidirectional_iterator_tag iterator_category;
- typedef ptrdiff_t difference_type;
- typedef T value_type;
- typedef const T *pointer;
- typedef const T &reference;
- inline const_iterator() {}
- inline const_iterator(QFuture const * const _future, int _index) : future(_future), index(_index) {}
- inline const_iterator(const const_iterator &o) : future(o.future), index(o.index) {}
- inline const_iterator &operator=(const const_iterator &o)
- { future = o.future; index = o.index; return *this; }
- inline const T &operator*() const { return future->d.resultReference(index); }
- inline const T *operator->() const { return future->d.resultPointer(index); }
- inline bool operator!=(const const_iterator &other) const
- {
- if (index == -1 && other.index == -1) // comparing end != end?
- return false;
- if (other.index == -1)
- return (future->isRunning() || (index < future->resultCount()));
- return (index != other.index);
- }
- inline bool operator==(const const_iterator &o) const { return !operator!=(o); }
- inline const_iterator &operator++() { ++index; return *this; }
- inline const_iterator operator++(int) { const_iterator r = *this; ++index; return r; }
- inline const_iterator &operator--() { --index; return *this; }
- inline const_iterator operator--(int) { const_iterator r = *this; --index; return r; }
- inline const_iterator operator+(int j) const { return const_iterator(future, index + j); }
- inline const_iterator operator-(int j) const { return const_iterator(future, index - j); }
- inline const_iterator &operator+=(int j) { index += j; return *this; }
- inline const_iterator &operator-=(int j) { index -= j; return *this; }
- private:
- QFuture const * future;
- int index;
- };
- friend class const_iterator;
- typedef const_iterator ConstIterator;
- const_iterator begin() const { return const_iterator(this, 0); }
- const_iterator constBegin() const { return const_iterator(this, 0); }
- const_iterator end() const { return const_iterator(this, -1); }
- const_iterator constEnd() const { return const_iterator(this, -1); }
- private:
- friend class QFutureWatcher<T>;
- public: // Warning: the d pointer is not documented and is considered private.
- mutable QFutureInterface<T> d;
- };
- template <typename T>
- inline QFuture<T> &QFuture<T>::operator=(const QFuture<T> &other)
- {
- d = other.d;
- return *this;
- }
- template <typename T>
- inline T QFuture<T>::result() const
- {
- d.waitForResult(0);
- return d.resultReference(0);
- }
- template <typename T>
- inline T QFuture<T>::resultAt(int index) const
- {
- d.waitForResult(index);
- return d.resultReference(index);
- }
- template <typename T>
- inline QFuture<T> QFutureInterface<T>::future()
- {
- return QFuture<T>(this);
- }
- Q_DECLARE_SEQUENTIAL_ITERATOR(Future)
- template <>
- class QFuture<void>
- {
- public:
- QFuture()
- : d(QFutureInterface<void>::canceledResult())
- { }
- explicit QFuture(QFutureInterfaceBase *p) // internal
- : d(*p)
- { }
- QFuture(const QFuture &other)
- : d(other.d)
- { }
- ~QFuture()
- { }
- QFuture &operator=(const QFuture &other);
- bool operator==(const QFuture &other) const { return (d == other.d); }
- bool operator!=(const QFuture &other) const { return (d != other.d); }
- #ifndef QT_NO_MEMBER_TEMPLATES
- template <typename T>
- QFuture(const QFuture<T> &other)
- : d(other.d)
- { }
- template <typename T>
- QFuture<void> &operator=(const QFuture<T> &other)
- {
- d = other.d;
- return *this;
- }
- #endif
- void cancel() { d.cancel(); }
- bool isCanceled() const { return d.isCanceled(); }
- void setPaused(bool paused) { d.setPaused(paused); }
- bool isPaused() const { return d.isPaused(); }
- void pause() { setPaused(true); }
- void resume() { setPaused(false); }
- void togglePaused() { d.togglePaused(); }
- bool isStarted() const { return d.isStarted(); }
- bool isFinished() const { return d.isFinished(); }
- bool isRunning() const { return d.isRunning(); }
- int resultCount() const { return d.resultCount(); }
- int progressValue() const { return d.progressValue(); }
- int progressMinimum() const { return d.progressMinimum(); }
- int progressMaximum() const { return d.progressMaximum(); }
- QString progressText() const { return d.progressText(); }
- void waitForFinished() { d.waitForFinished(); }
- private:
- friend class QFutureWatcher<void>;
- #ifdef QFUTURE_TEST
- public:
- #endif
- mutable QFutureInterfaceBase d;
- };
- inline QFuture<void> &QFuture<void>::operator=(const QFuture<void> &other)
- {
- d = other.d;
- return *this;
- }
- inline QFuture<void> QFutureInterface<void>::future()
- {
- return QFuture<void>(this);
- }
- template <typename T>
- QFuture<void> qToVoidFuture(const QFuture<T> &future)
- {
- return QFuture<void>(future.d);
- }
- QT_END_NAMESPACE
- QT_END_HEADER
- #endif // QT_NO_CONCURRENT
- #endif // QFUTURE_H