Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes