accumulate

Artigo
06/09/2015

Calcula a soma de todos os elementos em um intervalo especificado que inclui qualquer valor inicial calculando somas parciais sucessivas ou calcula o resultado de resultados parciais sucessivos obtidos da mesma forma de usar uma operação binária especificada diferente da soma.

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 
   );

Parâmetros

_First
Um iterador de entrada que trata o primeiro elemento no intervalo a ser somado ou combinados de acordo com uma operação binária especificada.
_Last
Um iterador de entrada que trata o elemento o mais recente no intervalo a ser somado ou combinados de acordo com uma operação binária especificada que é uma posição além de elemento final incluídos na verdade acumulação iterada.
_Val
Um valor inicial com que cada elemento por sua vez é adicionado ou combinado com de acordo com uma operação binária especificada.
_Binary_op
A operação binária que deve ser aplicada a cada elemento no intervalo especificado e o resultado de seus aplicativos anteriores.

Valor de retorno

A soma de _Val e de todos os elementos no intervalo especificado para a primeira função do modelo, ou, para a segunda função do modelo, o resultado da aplicação da operação binária especificada, em vez da operação de soma, a (PartialResult, *Iter), onde PartialResult é o resultado da operação anteriores de aplicativos e de Iter são um iterador que aponta para um elemento no intervalo.

Comentários

O valor inicial segura que haverá um resultado bem definido quando o intervalo estiver vazia, nesse caso _Val será retornado. A operação binário não precisa ser associativa ou comutativa. O resultado é inicializado com o valor inicial _Val e o resultado = _Binary_op (resultado, *****Iter) são calculados iterativa pelo intervalo, onde Iter é um iterador que aponta para o elemento sucessivo no intervalo. O intervalo deve ser válido e a complexidade é linear com o tamanho do intervalo. O tipo de retorno do operador binário deve ser convertido em Tipo garantir que o bloqueio durante a iteração.

Exemplo

// 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;
}

Requisitos

Cabeçalho: <numérico>

Namespace: std

Consulte também

Referência

accumulate, copy e vector::push_back

Biblioteca de Modelos Padrão

Compartilhar via