CKTIS / C++
std::adjacent_difference: diferenças entre elementos vizinhos
std::adjacent_difference escreve primeiro o primeiro elemento e depois os resultados entre o elemento atual e o anterior. Devolve o iterador após a saída.
Versão: C++23
Sintaxe
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, de <numeric>, transforma [first, last) para a saída em d_first. Com entrada não vazia, o primeiro resultado copia o primeiro elemento; os seguintes são current - previous ou binary_op(current, previous).
Para {2, 5, 9}, a operação predefinida produz {2, 3, 4}. Um intervalo vazio não escreve e devolve d_first. O destino precisa de tantos lugares quantos os da entrada.
A operação recebe primeiro o elemento atual e depois o anterior. Não pode alterar a entrada nem invalidar iteradores. d_first == first é permitido na sobrecarga sem política de execução. Com uma política, os intervalos de entrada e saída não podem sobrepor-se.
Exemplos
#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';
}
Resultado
2 3 4
std::adjacent_difference → 2 3 4