Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::adjacent_difference: differenze tra elementi vicini

std::adjacent_difference scrive prima il primo elemento e poi i risultati tra elemento corrente e precedente. Restituisce l’iteratore dopo l’output.

Versione: C++23

Sintassi

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 di <numeric> trasforma [first, last) nell’output da d_first. Con input non vuoto, il primo risultato copia il primo elemento; i successivi sono current - previous o binary_op(current, previous).

Per {2, 5, 9}, l’operazione predefinita produce {2, 3, 4}. Un intervallo vuoto non scrive e restituisce d_first. La destinazione deve contenere tanti elementi quanti l’input.

L’operazione riceve prima l’elemento corrente e poi il precedente. Non deve modificare l’input o invalidare iteratori. d_first == first è consentito nell’overload senza execution policy. Con una policy, gli intervalli di input e output non devono sovrapporsi.

Esempi

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

Risultato

2 3 4

std::adjacent_difference → 2 3 4

Fonti