Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::adjacent_difference: różnice sąsiednich elementów

std::adjacent_difference zapisuje pierwszy element, a potem wynik operacji między elementem bieżącym i poprzednim. Zwraca iterator za ostatnim wynikiem.

Wersja: C++23

Składnia

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 z <numeric> przekształca [first, last) do wyjścia od d_first. Dla niepustego wejścia pierwszy wynik jest kopią pierwszego elementu; następne to current - previous albo binary_op(current, previous).

Dla {2, 5, 9} domyślna operacja tworzy {2, 3, 4}. Pusty zakres niczego nie zapisuje i zwraca d_first. Cel musi mieścić tyle elementów, ile ma wejście.

Kolejność argumentów własnej operacji jest istotna: najpierw element bieżący, potem poprzedni. Operacja nie może zmieniać wejścia ani unieważniać iteratorów. d_first == first jest dopuszczone w przeciążeniu bez polityki wykonania. W przeciążeniu z polityką zakres wejściowy i wyjściowy nie mogą się nakładać.

Przykłady

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

Wynik

2 3 4

std::adjacent_difference → 2 3 4

Źródła