KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::copy_if: passende elementen stabiel kopiëren

std::copy_if test elk element, kopieert alleen elementen met een waar predicaat en retourneert het einde van het geschreven doeldeel.

Versie: C++23

Syntax

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) uit <algorithm> evalueert pred(*i) voor elk van de N elementen in [first, last) en kopieert elementen met een waar resultaat. Hun relatieve volgorde blijft behouden. Bij M geschreven waarden retourneert het de iterator die vanaf result M posities is opgeschoven; operator + is niet vereist.

Het predicaat wordt precies N keer aangeroepen. Het mag het bronelement niet wijzigen of iterators ongeldig maken. Het doel heeft ruimte nodig voor het slechtste geval, het hele bereik, tenzij een invoegiterator wordt gebruikt; het algoritme vergroot een gewone container niet zelf.

Bron [first, last) en de vanaf result beginnende reeks van de eerste N potentiële doelposities mogen niet overlappen, ook als minder elementen worden gekozen. Een predicaat- of toewijzingsexceptie onder elke standaardpolicy, ook seq, roept std::terminate aan. Een leeg bereik retourneert result.

Voorbeelden

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

Resultaat

2 4 2

std::copy_if → 2 4 2

Bronnen