WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::adjacent_difference: Differenzen benachbarter Elemente

std::adjacent_difference schreibt zuerst das erste Element und danach Ergebnisse aus aktuellem und vorherigem Element. Der Rückgabewert zeigt hinter die Ausgabe.

Version: C++23

Syntax

template<class InputIt, class OutputIt>
constexpr OutputIt adjacent_difference(InputIt first, InputIt last, OutputIt d_first);

template<class InputIt, class OutputIt, class BinaryOperation>
constexpr OutputIt adjacent_difference(InputIt first, InputIt last, OutputIt d_first, BinaryOperation op);

std::adjacent_difference aus <numeric> überführt [first, last) in die Ausgabe ab d_first. Bei nicht leerer Eingabe wird zuerst das erste Element kopiert; danach folgt current - previous oder binary_op(current, previous).

Aus {2, 5, 9} entsteht standardmäßig {2, 3, 4}. Ein leerer Bereich schreibt nichts und gibt d_first zurück. Das Ziel braucht ebenso viele Plätze wie die Eingabe.

Die eigene Operation erhält zuerst das aktuelle und dann das vorherige Element. Sie darf die Eingabe nicht ändern oder Iteratoren ungültig machen. d_first == first ist beim Overload ohne Ausführungsrichtlinie erlaubt. Bei einem Overload mit Richtlinie dürfen sich Eingabe- und Ausgabebereich nicht überlappen.

Beispiele

#include <array>
#include <iostream>
#include <numeric>

int main() {
    const std::array input{2, 5, 9};
    std::array<int, 3> output{};
    std::adjacent_difference(input.begin(), input.end(), output.begin());
    std::cout << output[0] << ' ' << output[1] << ' ' << output[2] << '\n';
}

Ergebnis

2 3 4

std::adjacent_difference → 2 3 4

Quellen