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

CKTIS / C++

std::copy_if: stabilní kopírování prvků splňujících predikát

std::copy_if otestuje každý prvek, zkopíruje jen prvky s pravdivým predikátem a vrátí konec zapsané části cíle.

Verze: C++23

Syntaxe

template<class InputIterator, class OutputIterator, class Predicate>
constexpr OutputIterator copy_if(InputIterator first, InputIterator last,
                                 OutputIterator result, Predicate pred);

std::copy_if(first, last, result, pred) z <algorithm> vyhodnotí pred(*i) pro každý z N prvků v [first, last) a zkopíruje ty s pravdivým výsledkem. Jejich relativní pořadí zachová. Zapíše-li M hodnot, vrátí iterátor posunutý o M pozic od result; operátor + není vyžadován.

Predikát je volán přesně Nkrát. Nemá měnit zdrojový prvek ani zneplatňovat iterátory. Cíl potřebuje místo pro nejhorší případ, celý rozsah, není-li použit vkládací iterátor; algoritmus sám běžný kontejner nezvětší.

Zdroj [first, last) a posloupnost prvních N potenciálních cílových pozic začínající v result se nesmějí překrývat, ani když se vybere méně prvků. Výjimka z predikátu či přiřazení pod libovolnou standardní politikou včetně seq volá std::terminate. Prázdný rozsah vrátí result.

Příklady

#include <algorithm>
#include <array>
#include <iostream>
#include <iterator>
#include <vector>

int main() {
    const std::vector<int> source{1, 4, 2, 5};
    std::array<int, 4> destination{};
    const auto end = std::copy_if(source.begin(), source.end(), destination.begin(),
                                  [](int value) { return value % 2 == 0; });
    const auto written = std::distance(destination.begin(), end);
    std::cout << written;
    for (auto it = destination.begin(); it != end; ++it) std::cout << ' ' << *it;
    std::cout << '\n';
}

Výsledek

2 4 2

std::copy_if → 2 4 2

Zdroje