CKTIS / C++
std::adjacent_difference: diferencias entre vecinos
std::adjacent_difference escribe primero el primer elemento y después los resultados entre cada elemento actual y anterior. Devuelve el iterador posterior a la salida.
Versión: C++23
Sintaxis
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) hacia d_first. Con entrada no vacía, el primer resultado copia el primer elemento; los siguientes son current - previous o binary_op(current, previous).
Para {2, 5, 9}, la operación predeterminada produce {2, 3, 4}. Un rango vacío no escribe nada y devuelve d_first. El destino necesita tantos espacios como la entrada.
La operación recibe primero el elemento actual y luego el anterior. No debe modificar la entrada ni invalidar iteradores. d_first == first está permitido en la sobrecarga sin política de ejecución. Con una política, los rangos de entrada y salida no deben solaparse.
Ejemplos
#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