count

Sintaxis

    #include <algorithm>
    NUMBER count( input_iterator inicio, input_iterator fin, const T& val );

• inicio y fin modelan Input Iterator.
• NUMBER es ptrdiff_t (diferencia entre enteros).

La función count() devuelve el número de veces que el valor val puede ser encontrado en el rango definido por inicio y fin.

Ejemplo

El código siguiente utiliza count() para contar cuántos números en un vector son iguales a target_value (por ejemplo, 3):

   vector<int> v;
   for( int i = 0; i < 10; i++ ) {
     v.push_back( i );
   }
 
   int target_value = 3;
   int num_items = count( v.begin(), v.end(), target_value );
 
   cout << "v contains " << num_items << " items matching " << target_value <<
  endl;

La salida de este código es como la siguiente:

   v contains 1 items matching 3

Detalles

Si el rango ['inicio...fin') se mantiene inmutable entre una llamada a count() y una llamada a find(), se cumple que:

( 0 != count(inicio,fin,val) ) <==> ( fin != find(inicio,fin,val) )

Tópicos Relacionados

• count_if -- cuenta las veces que los elementos de un rango cumplen una condición
• find, find_if -- encuentra un valor y entrega un iterador
• accumulate, adjacent_difference, inner_product