Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::adjacent_difference : différences entre voisins

std::adjacent_difference écrit d’abord le premier élément puis les résultats entre chaque élément courant et précédent. Le retour pointe après la sortie.

Version : C++23

Syntaxe

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> transforme [first, last) vers la sortie d_first. Si l’entrée n’est pas vide, le premier résultat copie le premier élément ; les suivants valent current - previous ou binary_op(current, previous).

Pour {2, 5, 9}, l’opération par défaut produit {2, 3, 4}. Une plage vide n’écrit rien et renvoie d_first. La destination doit contenir autant de places que l’entrée.

L’opération reçoit l’élément courant puis le précédent. Elle ne doit ni modifier l’entrée ni invalider les itérateurs. d_first == first est permis par la surcharge sans politique d’exécution. Avec une politique, les plages d’entrée et de sortie ne doivent pas se chevaucher.

Exemples

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

Résultat

2 3 4

std::adjacent_difference → 2 3 4

Sources