accumulate

透過計算執行部分和計算所有項目的總和中指定範圍內的陣列包含原始值或計算使用指定的二進位運算的方式取得的循序部分結果的結果刪除這個總和之外。

template<class InputIterator, class Type>
   Type accumulate(
      InputIterator _First, 
      InputIterator _Last, 
      Type _Val
   );
template<class InputIterator, class Type, class BinaryOperation>
   Type accumulate(
      InputIterator _First, 
      InputIterator _Last, 
      Type _Val, 
      BinaryOperation _Binary_op
   );

參數

• _First
  處理輸入的 Iterator 在根據指定的二進位作業要加總或合併的範圍中的第一個項目。

• _Last
  處理輸入的 Iterator 在根據是在最後一個項目以外之位置的指定二進位作業要加總或合併的範圍的最後一個項目在中逐一查看累積實際上由。

• _Val
  每個項目又加入或合併和以指定的二進位運算的初始值。

• _Binary_op
  要套用至指定的範圍和前一個應用程式的結果的每個項目的二進位運算。

傳回值

_Val 和所有項目的總和在指定範圍中第一個樣板函式的或，第二個樣板函式的，就會執行二進位運算的結果指定，而非一律反映組件和作業中，為 (PartialResult， *Iter)，其中是 PartialResult 作業和 Iter 的上一個應用程式的結果是一個 Iterator 指向的項目位於範圍內。

備註

原始值保證會具有完整定義的結果，在此範圍是空的時候，在這種情況下， _Val 傳回情況下。 這類的二進位運算不需要是結合或可交換的。 這個結果初始化為初始值 _Val 然後結果= _Binary_op (因此， *****Iter) 透過範圍重複計算， Iter 是指向該範圍內的連續項目的 Iterator。 範圍必須是有效的，而且複雜度是線性具有範圍的大小。 二元運算子的傳回型別必須可以轉換為 [型別] 在反覆項目期間確保關閉。

範例

// numeric_accum.cpp
// compile with: /EHsc
#include <vector>
#include <numeric>
#include <functional>
#include <iostream>

int main( )
{
   using namespace std;

   vector <int> v1, v2(20);
   vector <int>::iterator iter1, iter2;

   int i;
   for (i = 1; i < 21; i++)
   {
      v1.push_back(i);
   }

   cout << "The original vector v1 is:\n ( " ;
   for (iter1 = v1.begin(); iter1 != v1.end(); iter1++)
      cout << *iter1 << " ";
   cout << ")." << endl;

   // The first member function for the accumulated sum
   int total;
   total = accumulate(v1.begin(), v1.end(), 0);

   cout << "The sum of the integers from 1 to 20 is: "
        << total << "." << endl;

   // Constructing a vector of partial sums
   int j = 0, partotal;
   for (iter1 = v1.begin(); iter1 != v1.end(); iter1++)
   {
      partotal = accumulate(v1.begin(), iter1 + 1, 0);
      v2[j] = partotal;
      j++;
   }

   cout << "The vector of partial sums is:\n ( " ;
   for (iter2 = v2.begin(); iter2 != v2.end(); iter2++)
      cout << *iter2 << " ";
   cout << ")." << endl << endl;

   // The second member function for the accumulated product
   vector <int> v3, v4(10);
   vector <int>::iterator iter3, iter4;

   int s;
   for (s = 1; s < 11; s++)
   {
      v3.push_back(s);
   }

   cout << "The original vector v3 is:\n ( " ;
   for (iter3 = v3.begin(); iter3 != v3.end(); iter3++)
      cout << *iter3 << " ";
   cout << ")." << endl;

   int ptotal;
   ptotal = accumulate(v3.begin(), v3.end(), 1, multiplies<int>());

   cout << "The product of the integers from 1 to 10 is: "
        << ptotal << "." << endl;

   // Constructing a vector of partial products
   int k = 0, ppartotal;
   for (iter3 = v3.begin(); iter3 != v3.end(); iter3++) {
      ppartotal = accumulate(v3.begin(), iter3 + 1, 1, multiplies<int>());
      v4[k] = ppartotal;
      k++;
   }

   cout << "The vector of partial products is:\n ( " ;
   for (iter4 = v4.begin(); iter4 != v4.end(); iter4++)
      cout << *iter4 << " ";
   cout << ")." << endl;
}

需求

標題: <numeric>

命名空間: std

請參閱

參考

accumulate, copy, 和 vector::push_back

標準樣板程式庫