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