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

CKTIS / C++

std::count_if: contar elementos que satisfazem uma condição

std::count_if testa cada elemento de um intervalo com um predicado e devolve o número de resultados verdadeiros.

Versão: C++23

Sintaxe

template<class InputIterator, class Predicate>
constexpr typename std::iterator_traits<InputIterator>::difference_type
count_if(InputIterator first, InputIterator last, Predicate pred);

std::count_if(first, last, pred), de <algorithm>, avalia pred(*i) para cada iterador i em [first, last) e conta os resultados diferentes de false. O tipo devolvido é std::iterator_traits<InputIterator>::difference_type; um intervalo vazio produz zero.

Seja N o número de elementos do intervalo. A sobrecarga sem política de execução aplica o predicado exatamente N vezes, pelo que não termina na primeira correspondência. Basta um iterador de entrada; a sobrecarga com execution policy exige um iterador forward e pode avaliar concorrentemente ou sem ordem fixa.

O predicado tem de aceitar o valor obtido do iterador e produzir um resultado convertível em bool. A correção não pode depender da ordem das chamadas e o predicado não pode alterar elementos através do seu argumento. Uma exceção do código do utilizador sob qualquer política standard, incluindo seq, chama std::terminate.

Exemplos

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

int main() {
    const std::vector<int> values{-3, 0, 4, 7, -2};
    const auto positive = std::count_if(values.begin(), values.end(),
                                        [](int value) { return value > 0; });
    std::cout << positive << '\n';
}

Resultado

2

std::count_if → 2

Fontes