Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::any_of: czy istnieje pasujący element

std::any_of zwraca true, gdy predykat jest prawdziwy dla co najmniej jednego elementu. Pusty zakres zawsze daje false.

Wersja: C++23

Składnia

template<class InputIt, class UnaryPred>
constexpr bool any_of(InputIt first, InputIt last, UnaryPred predicate);

template<class ExecutionPolicy, class ForwardIt, class UnaryPred>
bool any_of(ExecutionPolicy&& policy, ForwardIt first, ForwardIt last, UnaryPred predicate);

std::any_of z <algorithm> sprawdza elementy [first, last) predykatem jednoargumentowym. W wersji sekwencyjnej może zakończyć pracę przy pierwszym true; jeśli nic nie pasuje, zwraca false. Dla pustego zakresu predykat nie jest wywoływany.

Funkcja dobrze wyraża pytanie o istnienie, bez ręcznej pętli. W najgorszym przypadku wywołuje predykat dla każdego elementu. Predykat nie może modyfikować elementu ani opierać poprawności na liczbie wywołań.

Przeciążenia z polityką wykonania mogą zmienić kolejność i wykonywać wywołania równolegle. Skutki uboczne muszą więc być bezpieczne, a przy dowolnej standardowej polityce wykonania, także std::execution::seq, nieprzechwycony wyjątek z predykatu powoduje std::terminate.

Przykłady

#include <algorithm>
#include <array>
#include <iostream>

int main() {
    const std::array values{1, 3, 6};
    const bool hasEven = std::any_of(values.begin(), values.end(), [](int value) {
        return value % 2 == 0;
    });
    std::cout << hasEven << '\n';
}

Wynik

1

std::any_of → 1

Źródła