std:: remove_copy, std:: remove_copy_if

Kopiert Elemente aus dem Bereich [ first , last ) in einen anderen Bereich, beginnend bei d_first , und lässt dabei Elemente aus, die bestimmte Kriterien erfüllen.

Wenn * d_first = * first ungültig ist (bis C++20) * first nicht schreibbar auf d_first (seit C++20) ist, ist das Programm fehlerhaft.

Wenn sich Quell- und Zielbereiche überlappen, ist das Verhalten undefiniert.

Parameter

Rückgabewert

Iterator auf das Element nach dem letzten kopierten Element.

Komplexität

Gegeben \(\scriptsize N\) N als std:: distance ( first, last ) :

Für die Überladungen mit einer ExecutionPolicy kann es zu Leistungseinbußen kommen, wenn ForwardIt1 's value_type nicht MoveConstructible ist.

Exceptions

Die Überladungen mit einem Template-Parameter namens ExecutionPolicy melden Fehler wie folgt:

• Wenn die Ausführung einer als Teil des Algorithmus aufgerufenen Funktion eine Exception wirft und ExecutionPolicy einer der Standard-Policies ist, wird std::terminate aufgerufen. Für jede andere ExecutionPolicy ist das Verhalten implementierungsdefiniert.
• Wenn der Algorithmus keinen Speicher allokieren kann, wird std::bad_alloc geworfen.

Mögliche Implementierung

template<class InputIt, class OutputIt,
         class T = typename std::iterator_traits<InputIt>::value_type>
constexpr OutputIt remove_copy(InputIt first, InputIt last,
                               OutputIt d_first, const T& value)
{
    for (; first != last; ++first)
        if (!(*first == value))
            *d_first++ = *first;
    return d_first;
}

template<class InputIt, class OutputIt, class UnaryPred>
constexpr OutputIt remove_copy_if(InputIt first, InputIt last,
                                  OutputIt d_first, UnaryPred p)
{
    for (; first != last; ++first)
        if (!p(*first))
            *d_first++ = *first;
    return d_first;
}

`-Tags C++-Code enthält und gemäß den Anweisungen nicht übersetzt werden soll, sowie HTML-Tags und Attribute unverändert bleiben müssen, wurde nur der strukturelle Rahmen der Tabelle beibehalten. Die Funktionsnamen und Code-Elemente bleiben auf Englisch, wie in den C++-Standards üblich.

Hinweise

Beispiel

#include <algorithm>
#include <complex>
#include <iomanip>
#include <iostream>
#include <iterator>
#include <string>
#include <vector>
int main()
{
    // Lösche die Raute-Zeichen '#' im Flug.
    std::string str = "#Return #Value #Optimization";
    std::cout << "before: " << std::quoted(str) << '\n';
    std::cout << "after:  \"";
    std::remove_copy(str.begin(), str.end(),
                     std::ostream_iterator<char>(std::cout), '#');
    std::cout << "\"\n";
    // Lösche {1, 3} Werte im Flug.
    std::vector<std::complex<double>> nums{{2, 2}, {1, 3}, {4, 8}, {1, 3}};
    std::remove_copy(nums.begin(), nums.end(),
                     std::ostream_iterator<std::complex<double>>(std::cout),
    #ifdef __cpp_lib_algorithm_default_value_type
                     {1, 3}); // T wird abgeleitet
    #else
                     std::complex<double>{1, 3});
    #endif
}

before: "#Return #Value #Optimization"
after:  "Return Value Optimization"
(2,2)(4,8)

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch