WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::count_if: Elemente zählen, die eine Bedingung erfüllen

std::count_if prüft jedes Element eines Bereichs mit einem Prädikat und liefert die Anzahl wahrer Ergebnisse.

Version: C++23

Syntax

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) aus <algorithm> wertet für jeden Iterator i in [first, last) den Ausdruck pred(*i) aus und zählt Ergebnisse ungleich false. Der Ergebnistyp ist std::iterator_traits<InputIterator>::difference_type; ein leerer Bereich ergibt null.

N sei die Anzahl der Elemente im Bereich. Der Overload ohne Ausführungsrichtlinie ruft das Prädikat genau N-mal auf und bricht daher nicht beim ersten Treffer ab. Ein Eingabeiterator genügt; der Policy-Overload verlangt einen Vorwärtsiterator und darf Elemente nebenläufig oder ohne feste Reihenfolge prüfen.

Das Prädikat muss den vom Iterator gelieferten Wert annehmen und ein nach bool konvertierbares Ergebnis liefern. Die Korrektheit darf nicht von der Aufrufreihenfolge abhängen, und das Prädikat darf Elemente nicht über sein Argument verändern. Eine Ausnahme aus Benutzercode unter jeder Standard-Execution-Policy, auch seq, ruft std::terminate auf.

Beispiele

#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';
}

Ergebnis

2

std::count_if → 2

Quellen