Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::count: počet prvků rovných hodnotě

std::count projde celý rozsah, porovná každý prvek s hodnotou a vrátí počet shod v difference_type iterátoru.

Verze: C++23

Syntaxe

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) z <algorithm> vrátí počet iterátorů i v [first, last), pro které platí *i == value. Výsledek má typ std::iterator_traits<InputIt>::difference_type. Prázdný rozsah dává nulu.

Nechť N je počet prvků v [first, last). Algoritmus provede přesně N porovnání a nekončí dříve. Stačí vstupní iterátor a je možný jediný průchod. Prvky nemění, ale rovnost musí být pro porovnávané typy platná.

Přetížení s execution policy vyžaduje forward iterátory a může porovnávat v jiném pořadí či souběžně. Výjimka z porovnání pod libovolnou standardní politikou včetně seq volá std::terminate; porovnání nesmí vytvořit data race. std::ranges::count je samostatné rozhraní s projekcí.

Příklady

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

Výsledek

3

std::count → 3

Zdroje