The QtConcurrent namespace provides high-level APIs that make it possible to write multi-threaded programs without using low-level threading primitives. 更多...
| 头： | #include <QtConcurrent> |
| qmake: | QT += concurrent |
| Since: | Qt 4.4 |
This namespace was introduced in Qt 4.4.
| enum | ReduceOption { UnorderedReduce, OrderedReduce, SequentialReduce } |
| flags | ReduceOptions |
| void | blockingFilter (Sequence & sequence , KeepFunctor filterFunction ) |
| Sequence | blockingFiltered (const Sequence & sequence , KeepFunctor filterFunction ) |
| OutputSequence | blockingFiltered (Iterator begin , Iterator end , KeepFunctor filterFunction ) |
| ResultType | blockingFilteredReduced (const Sequence & sequence , KeepFunctor filterFunction , ReduceFunctor reduceFunction , QtConcurrent::ReduceOptions reduceOptions = ReduceOptions(UnorderedReduce | SequentialReduce)) |
| ResultType | blockingFilteredReduced (Iterator begin , Iterator end , KeepFunctor filterFunction , ReduceFunctor reduceFunction , QtConcurrent::ReduceOptions reduceOptions = ReduceOptions(UnorderedReduce | SequentialReduce)) |
| void | blockingMap (Sequence & sequence , MapFunctor function ) |
| void | blockingMap (Iterator begin , Iterator end , MapFunctor function ) |
| OutputSequence | blockingMapped (const InputSequence & sequence , MapFunctor function ) |
| Sequence | blockingMapped (Iterator begin , Iterator end , MapFunctor function ) |
| ResultType | blockingMappedReduced (const Sequence & sequence , MapFunctor mapFunction , ReduceFunctor reduceFunction , QtConcurrent::ReduceOptions reduceOptions = ReduceOptions(UnorderedReduce | SequentialReduce)) |
| ResultType | blockingMappedReduced (Iterator begin , Iterator end , MapFunctor mapFunction , ReduceFunctor reduceFunction , QtConcurrent::ReduceOptions reduceOptions = QtConcurrent::ReduceOptions(QtConcurrent::UnorderedReduce | QtConcurrent::SequentialReduce)) |
| QFuture<void> | filter (Sequence & sequence , KeepFunctor filterFunction ) |
| QFuture<typename Sequence::value_type> | filtered (const Sequence & sequence , KeepFunctor filterFunction ) |
| QFuture<typename qValueType<Iterator>::value_type> | filtered (Iterator begin , Iterator end , KeepFunctor filterFunction ) |
| QFuture<ResultType> | filteredReduced (const Sequence & sequence , KeepFunctor filterFunction , ReduceFunctor reduceFunction , QtConcurrent::ReduceOptions reduceOptions = ReduceOptions(UnorderedReduce | SequentialReduce)) |
| QFuture<ResultType> | filteredReduced (Iterator begin , Iterator end , KeepFunctor filterFunction , ReduceFunctor reduceFunction , QtConcurrent::ReduceOptions reduceOptions = ReduceOptions(UnorderedReduce | SequentialReduce)) |
| QFuture<void> | map (Sequence & sequence , MapFunctor function ) |
| QFuture<void> | map (Iterator begin , Iterator end , MapFunctor function ) |
| QFuture<typename QtPrivate::MapResultType<void, MapFunctor>::ResultType> | mapped (const Sequence & sequence , MapFunctor function ) |
| QFuture<typename QtPrivate::MapResultType<void, MapFunctor>::ResultType> | mapped (Iterator begin , Iterator end , MapFunctor function ) |
| QFuture<ResultType> | mappedReduced (const Sequence & sequence , MapFunctor mapFunction , ReduceFunctor reduceFunction , QtConcurrent::ReduceOptions reduceOptions = ReduceOptions(UnorderedReduce | SequentialReduce)) |
| QFuture<ResultType> | mappedReduced (Iterator begin , Iterator end , MapFunctor mapFunction , ReduceFunctor reduceFunction , QtConcurrent::ReduceOptions reduceOptions = ReduceOptions(UnorderedReduce | SequentialReduce)) |
| QFuture<T> | run (Function function , ... ) |
| QFuture<T> | run (QThreadPool * pool , Function function , ... ) |
见 Qt Concurrent 模块文档编制了解可用函数的概述，或见下文了解每个函数的详细信息。
This enum specifies the order of which results from the map or filter function are passed to the reduce function.
| 常量 | 值 | 描述 |
|---|---|---|
QtConcurrent::UnorderedReduce
|
0x1
|
按任意次序履行缩减。 |
QtConcurrent::OrderedReduce
|
0x2
|
Reduction is done in the order of the original sequence. |
QtConcurrent::SequentialReduce
|
0x4
|
Reduction is done sequentially: only one thread will enter the reduce function at a time. (Parallel reduction might be supported in a future version of Qt Concurrent.) |
The ReduceOptions type is a typedef for QFlags <ReduceOption>. It stores an OR combination of ReduceOption values.
调用
filterFunction
once for each item in
sequence
。若
filterFunction
返回
true
, the item is kept in
sequence
; otherwise, the item is removed from
sequence
.
注意： 此函数将阻塞，直到已处理所有序列项。
另请参阅 并发过滤和过滤缩减 .
调用
filterFunction
once for each item in
sequence
and returns a new Sequence of kept items. If
filterFunction
返回
true
, a copy of the item is put in the new Sequence. Otherwise, the item will
not
appear in the new Sequence.
注意： 此函数将阻塞，直到已处理所有序列项。
另请参阅 filtered () 和 并发过滤和过滤缩减 .
调用
filterFunction
once for each item from
begin
to
end
and returns a new Sequence of kept items. If
filterFunction
返回
true
, a copy of the item is put in the new Sequence. Otherwise, the item will
not
appear in the new Sequence.
注意： 此函数将阻塞，直到迭代器到达正处理序列的末尾。
另请参阅 filtered () 和 并发过滤和过滤缩减 .
调用
filterFunction
once for each item in
sequence
。若
filterFunction
返回
true
for an item, that item is then passed to
reduceFunction
. In other words, the return value is the result of
reduceFunction
for each item where
filterFunction
返回
true
.
Note that while filterFunction is called concurrently, only one thread at a time will call reduceFunction . The order in which reduceFunction is called is undefined if reduceOptions is QtConcurrent::UnorderedReduce 。若 reduceOptions is QtConcurrent::OrderedReduce , reduceFunction is called in the order of the original sequence.
注意： 此函数将阻塞，直到已处理所有序列项。
另请参阅 filteredReduced () 和 并发过滤和过滤缩减 .
调用
filterFunction
once for each item from
begin
to
end
。若
filterFunction
返回
true
for an item, that item is then passed to
reduceFunction
. In other words, the return value is the result of
reduceFunction
for each item where
filterFunction
返回
true
.
Note that while filterFunction is called concurrently, only one thread at a time will call reduceFunction . The order in which reduceFunction is called is undefined if reduceOptions is QtConcurrent::UnorderedReduce 。若 reduceOptions is QtConcurrent::OrderedReduce ， reduceFunction is called in the order of the original sequence.
注意： 此函数将阻塞，直到迭代器到达正处理序列的末尾。
另请参阅 filteredReduced () 和 并发过滤和过滤缩减 .
调用 function once for each item in sequence 。 function is passed a reference to the item, so that any modifications done to the item will appear in sequence .
注意： 此函数将阻塞，直到已处理所有序列项。
调用 function once for each item from begin to end 。 function is passed a reference to the item, so that any modifications done to the item will appear in the sequence which the iterators belong to.
注意： 此函数将阻塞，直到迭代器到达正处理序列的末尾。
调用 function once for each item in sequence and returns an OutputSequence containing the results. The type of the results will match the type returned my the MapFunctor.
注意： 此函数将阻塞，直到已处理所有序列项。
调用 function once for each item from begin to end and returns a container with the results. Specify the type of container as the a template argument, like this:
QList<int> ints = QtConcurrent::blockingMapped<QList<int> >(beginIterator, endIterator, fn);
注意： 此函数将阻塞，直到迭代器到达正处理序列的末尾。
调用 mapFunction once for each item in sequence . The return value of each mapFunction 会被传递给 reduceFunction .
Note that while mapFunction is called concurrently, only one thread at a time will call reduceFunction . The order in which reduceFunction is called is determined by reduceOptions .
注意： 此函数将阻塞，直到已处理所有序列项。
调用 mapFunction once for each item from begin to end . The return value of each mapFunction 会被传递给 reduceFunction .
Note that while mapFunction is called concurrently, only one thread at a time will call reduceFunction . The order in which reduceFunction is called is undefined.
注意： 此函数将阻塞，直到迭代器到达正处理序列的末尾。
另请参阅 blockingMappedReduced () 和 并发映射和映射缩减 .
调用
filterFunction
once for each item in
sequence
。若
filterFunction
返回
true
, the item is kept in
sequence
; otherwise, the item is removed from
sequence
.
另请参阅 并发过滤和过滤缩减 .
调用
filterFunction
once for each item in
sequence
and returns a new Sequence of kept items. If
filterFunction
返回
true
, a copy of the item is put in the new Sequence. Otherwise, the item will
not
appear in the new Sequence.
另请参阅 并发过滤和过滤缩减 .
调用
filterFunction
once for each item from
begin
to
end
and returns a new Sequence of kept items. If
filterFunction
返回
true
, a copy of the item is put in the new Sequence. Otherwise, the item will
not
appear in the new Sequence.
另请参阅 并发过滤和过滤缩减 .
调用
filterFunction
once for each item in
sequence
。若
filterFunction
返回
true
for an item, that item is then passed to
reduceFunction
. In other words, the return value is the result of
reduceFunction
for each item where
filterFunction
返回
true
.
Note that while filterFunction is called concurrently, only one thread at a time will call reduceFunction . The order in which reduceFunction is called is undefined if reduceOptions is QtConcurrent::UnorderedReduce 。若 reduceOptions is QtConcurrent::OrderedReduce , reduceFunction is called in the order of the original sequence.
另请参阅 并发过滤和过滤缩减 .
调用
filterFunction
once for each item from
begin
to
end
。若
filterFunction
返回
true
for an item, that item is then passed to
reduceFunction
. In other words, the return value is the result of
reduceFunction
for each item where
filterFunction
返回
true
.
Note that while filterFunction is called concurrently, only one thread at a time will call reduceFunction . The order in which reduceFunction is called is undefined if reduceOptions is QtConcurrent::UnorderedReduce 。若 reduceOptions is QtConcurrent::OrderedReduce ， reduceFunction is called in the order of the original sequence.
另请参阅 并发过滤和过滤缩减 .
调用 function once for each item in sequence 。 function is passed a reference to the item, so that any modifications done to the item will appear in sequence .
另请参阅 并发映射和映射缩减 .
调用 function once for each item from begin to end 。 function is passed a reference to the item, so that any modifications done to the item will appear in the sequence which the iterators belong to.
另请参阅 并发映射和映射缩减 .
调用 function once for each item in sequence and returns a future with each mapped item as a result. You can use QFuture::const_iterator or QFutureIterator to iterate through the results.
另请参阅 并发映射和映射缩减 .
调用 function once for each item from begin to end and returns a future with each mapped item as a result. You can use QFuture::const_iterator or QFutureIterator to iterate through the results.
另请参阅 并发映射和映射缩减 .
调用 mapFunction once for each item in sequence . The return value of each mapFunction 会被传递给 reduceFunction .
Note that while mapFunction is called concurrently, only one thread at a time will call reduceFunction . The order in which reduceFunction is called is determined by reduceOptions .
另请参阅 并发映射和映射缩减 .
调用 mapFunction once for each item from begin to end . The return value of each mapFunction 会被传递给 reduceFunction .
Note that while mapFunction is called concurrently, only one thread at a time will call reduceFunction . By default, the order in which reduceFunction is called is undefined.
注意： QtConcurrent::OrderedReduce results in the ordered reduction.
另请参阅 并发映射和映射缩减 .
相当于
QtConcurrent::run(QThreadPool::globalInstance(), function, ...);
运行 function in a separate thread. The thread is taken from the global QThreadPool 。注意， function may not run immediately; function will only be run once a thread becomes available.
T is the same type as the return value of function . Non-void return values can be accessed via the QFuture::result () 函数。
注意： The QFuture returned can only be used to query for the running/finished status and the return value of the function. In particular, canceling or pausing can be issued only if the computations behind the future has not been started.
另请参阅 并发运行 and QThreadPool::start ().
调度 function on pool 。注意， function may not run immediately; function will only be run once a thread becomes available.
T is the same type as the return value of function . Non-void return values can be accessed via the QFuture::result () 函数。
注意： The QFuture returned can only be used to query for the running/finished status and the return value of the function. In particular, canceling or pausing can be issued only if the computations behind the future has not been started.
该函数在 Qt 5.4 引入。
另请参阅 并发运行 and QThreadPool::start ().
