Boost C++ 库

...世界上最受推崇、设计最精良的 C++ 库项目之一。 — Herb Sutter 和 Andrei Alexandrescu，C++ 编码标准

函数 test_some - Boost C++ 函数库

函数 test_some

boost::mpi::test_some — 测试是否有非阻塞请求已完成。

提要

// In header: <boost/mpi/nonblocking.hpp>


template<typename BidirectionalIterator, typename OutputIterator> 
  std::pair< OutputIterator, BidirectionalIterator > 
  test_some(BidirectionalIterator first, BidirectionalIterator last, 
            OutputIterator out);
template<typename BidirectionalIterator> 
  BidirectionalIterator 
  test_some(BidirectionalIterator first, BidirectionalIterator last);

描述

此例程接收存储在迭代器范围 [first,last) 中的一组请求，并测试是否有任何请求已完成。它会完成所有可以完成的请求，将输入序列划分为未决请求和已完成请求。如果提供了输出迭代器，则会为每个已完成的请求发出 status 对象。此例程类似于 wait_some，但不会等待直到有请求完成。此例程提供的功能等同于 MPI_Testsome。

参数

`first`	迭代器，表示请求对象序列的开始。
`last`	迭代器，表示请求对象序列的结束。它可能不等于 `first`。
`out`	如果提供了 `status` 对象，则对应于已完成请求的 `status` 对象将通过此输出迭代器发出。

返回

如果提供了 out 参数，则会返回一个 pair，其中包含所有 status 对象写入后的输出迭代器 out，以及一个引用第一个已完成请求的迭代器。如果未提供 out 参数，则只返回引用第一个已完成请求的迭代器。