Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::count: contar elementos iguais a um valor

std::count percorre todo o intervalo, compara cada elemento com um valor e devolve o número de correspondências no difference_type do iterador.

Versão: C++23

Sintaxe

template<class InputIterator, class T>
constexpr typename std::iterator_traits<InputIterator>::difference_type
count(InputIterator first, InputIterator last, const T& value);

std::count(first, last, value), de <algorithm>, devolve o número de iteradores i em [first, last) para os quais *i == value. O resultado é std::iterator_traits<InputIt>::difference_type. Um intervalo vazio dá zero.

Seja N o número de elementos em [first, last). O algoritmo realiza exatamente N comparações e não termina cedo. Basta um iterador de entrada e é possível uma passagem única. Não altera elementos, mas a igualdade tem de ser válida para os tipos comparados.

A sobrecarga com execution policy exige iteradores forward e pode comparar noutra ordem ou em paralelo. Uma exceção de comparação sob qualquer política padrão, incluindo seq, chama std::terminate; a comparação não pode criar data race. std::ranges::count é uma interface separada que suporta projeção.

Exemplos

#include <algorithm>
#include <iostream>
#include <vector>

int main() {
    const std::vector<int> values{2, 1, 2, 3, 2};
    std::cout << std::count(values.begin(), values.end(), 2) << '\n';
}

Resultado

3

std::count → 3

Fontes