Пространство имён QtConcurrent

Пространство имён QtConcurrent предоставляет высокоуровневые API, которые позволяют писать многопоточные программы без использования низкоуровневых примитивов многопоточности. Подробнее...

Это пространство имён было введено в Qt 4.4.

• Устаревшие члены

Типы

Функции

Подробное описание

См. документацию модуля Qt Concurrent для обзора доступных функций, или см. ниже для подробной информации о каждой функции.

Описание типа

enum QtConcurrent::ReduceOptionflags QtConcurrent::ReduceOptions

Этот перечисление указывает порядок, в котором результаты функции map или filter передаются функции reduce.

Тип ReduceOptions является typedef для QFlags<ReduceOption>. Он хранит комбинацию значений ReduceOption, объединённых операцией ИЛИ.

Описание функции

void QtConcurrent::blockingFilter(Sequence &sequence, KeepFunctor filterFunction)

Вызывает filterFunction один раз для каждого элемента в sequence. Если filterFunction возвращает true, элемент сохраняется в sequence; в противном случае, элемент удаляется из sequence.

Примечание: Эта функция будет блокироваться до тех пор, пока все элементы в последовательности не будут обработаны.

См. также Конкурентная фильтрация и фильтрация-сведение.

Sequence QtConcurrent::blockingFiltered(const Sequence &sequence, KeepFunctor filterFunction)

Вызывает filterFunction один раз для каждого элемента в sequence и возвращает новую Sequence сохранённых элементов. Если filterFunction возвращает true, копия элемента помещается в новую Sequence. В противном случае, элемент не будет присутствовать в новой Sequence.

Примечание: Эта функция будет блокироваться до тех пор, пока все элементы в последовательности не будут обработаны.

См. также filtered() и Конкурентная фильтрация и фильтрация-сведение.

OutputSequence QtConcurrent::blockingFiltered(Iterator begin, Iterator end, KeepFunctor filterFunction)

Вызывает filterFunction один раз для каждого элемента от begin до end и возвращает новый список сохранённых элементов. Если filterFunction возвращает true, копия элемента добавляется в новый список. В противном случае элемент не будет отображаться в новом списке.

Примечание: Эта функция будет заблокирована до тех пор, пока итератор не достигнет конца обрабатываемой последовательности.

См. также filtered() и Конкурентный фильтр и фильтр-сведение.

ResultType QtConcurrent::blockingFilteredReduced(const Sequence &sequence, KeepFunctor filterFunction, ReduceFunctor reduceFunction, QtConcurrent::ReduceOptions reduceOptions = ReduceOptions(UnorderedReduce | SequentialReduce))

Вызывает filterFunction для каждого элемента в sequence. Если filterFunction возвращает true для элемента, этот элемент передаётся в reduceFunction. Другими словами, возвращаемое значение — результат reduceFunction для каждого элемента, где filterFunction возвращает true.

Обратите внимание, что, хотя filterFunction вызывается параллельно, только один поток одновременно вызовет reduceFunction. Порядок, в котором вызывается reduceFunction, не определён, если reduceOptions равен QtConcurrent::UnorderedReduce. Если reduceOptions равен QtConcurrent::OrderedReduce, reduceFunction вызывается в порядке исходной последовательности.

Примечание: Эта функция будет заблокирована до тех пор, пока все элементы в последовательности не будут обработаны.

См. также filteredReduced() и Конкурентный фильтр и фильтр-сведение.

ResultType QtConcurrent::blockingFilteredReduced(Iterator begin, Iterator end, KeepFunctor filterFunction, ReduceFunctor reduceFunction, QtConcurrent::ReduceOptions reduceOptions = ReduceOptions(UnorderedReduce | SequentialReduce))

Вызывает filterFunction один раз для каждого элемента от begin до end. Если filterFunction возвращает true для элемента, этот элемент передаётся в reduceFunction. Другими словами, возвращаемое значение — результат reduceFunction для каждого элемента, где filterFunction возвращает true.

Обратите внимание, что, хотя filterFunction вызывается параллельно, только один поток одновременно вызовет reduceFunction. Порядок, в котором вызывается reduceFunction, не определён, если reduceOptions равен QtConcurrent::UnorderedReduce. Если reduceOptions равен QtConcurrent::OrderedReduce, reduceFunction вызывается в порядке исходной последовательности.

Примечание: Эта функция будет заблокирована до тех пор, пока итератор не достигнет конца обрабатываемой последовательности.

См. также filteredReduced() и Конкурентный фильтр и фильтр-сведение.

void QtConcurrent::blockingMap(Sequence &sequence, MapFunctor function)

Вызывает function один раз для каждого элемента в sequence. Функция function получает ссылку на элемент, поэтому любые изменения, внесённые в элемент, отобразятся в sequence.

Примечание: Эта функция будет заблокирована до тех пор, пока все элементы в последовательности не будут обработаны.

См. также map() и Конкурентное отображение и отображение-сведение.

void QtConcurrent::blockingMap(Iterator begin, Iterator end, MapFunctor function)

Вызывает function один раз для каждого элемента от begin до end. Функция function получает ссылку на элемент, поэтому любые изменения, внесённые в элемент, отобразятся в последовательности, к которой относятся итераторы.

Примечание: Эта функция будет заблокирована до тех пор, пока итератор не достигнет конца обрабатываемой последовательности.

См. также map() и Конкурентное отображение и отображение-сведение.

OutputSequence QtConcurrent::blockingMapped(const InputSequence &sequence, MapFunctor function)

Вызывает function один раз для каждого элемента в sequence и возвращает OutputSequence, содержащую результаты. Тип результатов будет соответствовать типу, возвращаемому MapFunctor.

Примечание: Эта функция будет заблокирована до тех пор, пока все элементы в последовательности не будут обработаны.

См. также mapped() и Конкурентное отображение и отображение-сведение.

Sequence QtConcurrent::blockingMapped(Iterator begin, Iterator end, MapFunctor function)

Вызывает function один раз для каждого элемента от begin до end и возвращает контейнер с результатами. Укажите тип контейнера в качестве аргумента шаблона, например:

QList<int> ints = QtConcurrent::blockingMapped<QList<int> >(beginIterator, endIterator, fn);

Примечание: Эта функция будет заблокирована до тех пор, пока итератор не достигнет конца обрабатываемой последовательности.

См. также mapped() и Конкурентное отображение и отображение-сведение.

ResultType QtConcurrent::blockingMappedReduced(const Sequence &sequence, MapFunctor mapFunction, ReduceFunctor reduceFunction, QtConcurrent::ReduceOptions reduceOptions = ReduceOptions(UnorderedReduce | SequentialReduce))

Вызывает mapFunction один раз для каждого элемента в sequence. Возвращаемое значение каждого mapFunction передаётся в reduceFunction.

Обратите внимание, что, хотя mapFunction вызывается параллельно, только один поток одновременно вызовет reduceFunction. Порядок, в котором вызывается reduceFunction, определяется reduceOptions.

Примечание: Эта функция будет заблокирована до тех пор, пока все элементы в последовательности не будут обработаны.

См. также mapped() и Конкурентное отображение и отображение-сведение.

ResultType QtConcurrent::blockingMappedReduced(Iterator begin, Iterator end, MapFunctor mapFunction, ReduceFunctor reduceFunction, QtConcurrent::ReduceOptions reduceOptions = QtConcurrent::ReduceOptions(QtConcurrent::UnorderedReduce | QtConcurrent::SequentialReduce))

Вызывает mapFunction один раз для каждого элемента от begin до end. Возвращаемое значение каждого mapFunction передаётся в reduceFunction.

Обратите внимание, что, хотя mapFunction вызывается параллельно, только один поток одновременно вызовет reduceFunction. Порядок, в котором вызывается reduceFunction, не определён.

Примечание: Эта функция будет заблокирована до тех пор, пока итератор не достигнет конца обрабатываемой последовательности.

См. также blockingMappedReduced() и Конкурентное отображение и отображение-сведение.

QFuture<void> QtConcurrent::filter(Sequence &sequence, KeepFunctor filterFunction)

Вызывает filterFunction для каждого элемента в sequence. Если filterFunction возвращает true, элемент сохраняется в sequence; в противном случае, элемент удаляется из sequence.

См. также Конкурентный фильтр и фильтр-сведение.

QFuture<typename Sequence::value_type> QtConcurrent::filtered(const Sequence &sequence, KeepFunctor filterFunction)

Вызывает filterFunction для каждого элемента в sequence и возвращает новый список сохранённых элементов. Если filterFunction возвращает true, копия элемента добавляется в новый список. В противном случае элемент не будет отображаться в новом списке.

См. также Конкурентный фильтр и фильтр-сведение.

QFuture<typename qValueType<Iterator>::value_type> QtConcurrent::filtered(Iterator begin, Iterator end, KeepFunctor filterFunction)

Вызывает filterFunction один раз для каждого элемента от begin до end и возвращает новый список сохранённых элементов. Если filterFunction возвращает true, копия элемента добавляется в новый список. В противном случае элемент не будет отображаться в новом списке.

См. также Конкурентный фильтр и фильтр-сведение.

QFuture<ResultType> QtConcurrent::filteredReduced(const Sequence &sequence, KeepFunctor filterFunction, ReduceFunctor reduceFunction, QtConcurrent::ReduceOptions reduceOptions = ReduceOptions(UnorderedReduce | SequentialReduce))

Вызывает filterFunction один раз для каждого элемента в sequence. Если filterFunction возвращает true для элемента, этот элемент передаётся в reduceFunction. Другими словами, возвращаемое значение — результат работы reduceFunction для каждого элемента, для которого filterFunction возвращает true.

Обратите внимание, что, хотя filterFunction вызывается параллельно, reduceFunction вызывается только одной нитью за раз. Порядок вызова reduceFunction не определён, если reduceOptions равен QtConcurrent::UnorderedReduce. Если reduceOptions равен QtConcurrent::OrderedReduce, reduceFunction вызывается в порядке исходной последовательности.

См. также Параллельное фильтрация и фильтрация-сведение.

QFuture<ResultType> QtConcurrent::filteredReduced(Iterator begin, Iterator end, KeepFunctor filterFunction, ReduceFunctor reduceFunction, QtConcurrent::ReduceOptions reduceOptions = ReduceOptions(UnorderedReduce | SequentialReduce))

Вызывает filterFunction один раз для каждого элемента от begin до end. Если filterFunction возвращает true для элемента, этот элемент передаётся в reduceFunction. Другими словами, возвращаемое значение — результат работы reduceFunction для каждого элемента, для которого filterFunction возвращает true.

Обратите внимание, что, хотя filterFunction вызывается параллельно, reduceFunction вызывается только одной нитью за раз. Порядок вызова reduceFunction не определён, если reduceOptions равен QtConcurrent::UnorderedReduce. Если reduceOptions равен QtConcurrent::OrderedReduce, reduceFunction вызывается в порядке исходной последовательности.

См. также Параллельное фильтрация и фильтрация-сведение.

QFuture<void> QtConcurrent::map(Sequence &sequence, MapFunctor function)

Вызывает function один раз для каждого элемента в sequence. function получает ссылку на элемент, поэтому любые изменения, внесённые в элемент, будут видны в sequence.

См. также Параллельное отображение и отображение-сведение.

QFuture<void> QtConcurrent::map(Iterator begin, Iterator end, MapFunctor function)

Вызывает function один раз для каждого элемента от begin до end. function получает ссылку на элемент, поэтому любые изменения, внесённые в элемент, будут видны в последовательности, к которой относятся итераторы.

См. также Параллельное отображение и отображение-сведение.

QFuture<typename QtPrivate::MapResultType<void, MapFunctor>::ResultType> QtConcurrent::mapped(const Sequence &sequence, MapFunctor function)

Вызывает function один раз для каждого элемента в sequence и возвращает будущее с каждым отображённым элементом в качестве результата. Для итерации по результатам можно использовать QFuture::const_iterator или QFutureIterator.

См. также Параллельное отображение и отображение-сведение.

QFuture<typename QtPrivate::MapResultType<void, MapFunctor>::ResultType> QtConcurrent::mapped(Iterator begin, Iterator end, MapFunctor function)

Вызывает function один раз для каждого элемента от begin до end и возвращает будущее с каждым отображённым элементом в качестве результата. Для итерации по результатам можно использовать QFuture::const_iterator или QFutureIterator.

См. также Параллельное отображение и отображение-сведение.

QFuture<ResultType> QtConcurrent::mappedReduced(const Sequence &sequence, MapFunctor mapFunction, ReduceFunctor reduceFunction, QtConcurrent::ReduceOptions reduceOptions = ReduceOptions(UnorderedReduce | SequentialReduce))

Вызывает mapFunction один раз для каждого элемента в sequence. Возвращаемое значение каждого mapFunction передаётся в reduceFunction.

Обратите внимание, что, хотя mapFunction вызывается параллельно, reduceFunction вызывается только одной нитью за раз. Порядок вызова reduceFunction определяется параметром reduceOptions.

См. также Параллельное отображение и отображение-сведение.

QFuture<ResultType> QtConcurrent::mappedReduced(Iterator begin, Iterator end, MapFunctor mapFunction, ReduceFunctor reduceFunction, QtConcurrent::ReduceOptions reduceOptions = ReduceOptions(UnorderedReduce | SequentialReduce))

Вызывает mapFunction один раз для каждого элемента от begin до end. Возвращаемое значение каждого mapFunction передаётся в reduceFunction.

Обратите внимание, что, хотя mapFunction вызывается параллельно, reduceFunction вызывается только одной нитью за раз. По умолчанию порядок вызова reduceFunction не определён.

Примечание: QtConcurrent::OrderedReduce приводит к упорядоченному сведению.

См. также Параллельное отображение и отображение-сведение.

QFuture<T> QtConcurrent::run(Function function, ...)

Эквивалентно

QtConcurrent::run(QThreadPool::globalInstance(), function, ...);

Выполняет function в отдельной нити. Нить берётся из глобального QThreadPool. Обратите внимание, что function может не запуститься сразу; function будет запущен только когда освободится нить.

T — тот же тип, что и возвращаемое значение function. Возвращаемые значения, отличные от void, могут быть получены с помощью функции QFuture::result().

Примечание: Возвращённое QFuture можно использовать только для запроса состояния выполнения/завершения и возвращаемого значения функции. В частности, отмена или приостановка могут быть выполнены только в том случае, если вычисления, стоящие за будущим, ещё не начаты.

См. также Параллельное выполнение.

QFuture<T> QtConcurrent::run(QThreadPool *pool, Function function, ...)

Выполняет function в отдельной нити. Нить берётся из QThreadPool pool. Обратите внимание, что function может не запуститься сразу; function будет запущен только когда освободится нить.

T — тот же тип, что и возвращаемое значение function. Возвращаемые значения, отличные от void, могут быть получены с помощью функции QFuture::result().

Примечание: Возвращённое QFuture можно использовать только для запроса состояния выполнения/завершения и возвращаемого значения функции. В частности, отмена или приостановка могут быть выполнены только в том случае, если вычисления, стоящие за будущим, ещё не начаты.

Эта функция была введена в Qt 5.4.

См. также Параллельное выполнение.