KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::count: elementen tellen die gelijk zijn aan een waarde

std::count doorloopt het hele bereik, vergelijkt elk element met een waarde en retourneert het aantal treffers in de difference_type van de iterator.

Versie: C++23

Syntax

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) uit <algorithm> retourneert het aantal iterators i in [first, last) waarvoor *i == value geldt. Het resultaattype is std::iterator_traits<InputIt>::difference_type. Een leeg bereik geeft nul.

Laat N het aantal elementen in [first, last) zijn. Het algoritme voert precies N vergelijkingen uit en stopt niet vroeg. Een invoeriterator volstaat en één doorgang is mogelijk. Elementen worden niet gewijzigd, maar gelijkheid moet geldig zijn voor de vergeleken typen.

De execution-policy-overload vereist forward iterators en kan in andere volgorde of parallel vergelijken. Een vergelijkingsexceptie onder elke standaardpolicy, ook seq, roept std::terminate aan; de vergelijking mag geen data race maken. std::ranges::count is een afzonderlijke interface met projectie.

Voorbeelden

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

Resultaat

3

std::count → 3

Bronnen