CKTIS / C++
std::ptrdiff_t — type de différence entre pointeurs
std::ptrdiff_t est un type entier signé défini par l’implémentation, fourni par <cstddef>. C’est le type de résultat de la soustraction de pointeurs : il représente une distance en éléments, et non en octets, et peut contenir des valeurs négatives.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cstddef>
std::ptrdiff_t distance = last - first;std::ptrdiff_t, disponible après l’inclusion de <cstddef>, est un alias pour un type entier signé choisi par l’implémentation. Ne supposez pas qu’il s’agit de int ou de long, ni qu’il a une largeur fixe. La soustraction intégrée de pointeurs produit un résultat de ce type.
Pour des pointeurs vers des éléments d’un même tableau, last - first désigne la différence entre leurs indices, et non un nombre d’octets. Un pointeur situé juste après la fin du tableau peut être utilisé, mais ne doit pas être déréférencé. Inverser les opérandes inverse le signe du résultat.
Soustraire des pointeurs vers des tableaux distincts entraîne un comportement indéfini, même si leurs adresses sont proches. Une différence qui ne peut pas être représentée par std::ptrdiff_t entraîne également un comportement indéfini. Stocker le résultat dans un type plus large ne corrige pas la soustraction elle-même.
À l’inverse, std::size_t est un type non signé utilisé notamment pour les tailles des objets en octets. Ne l’utilisez pas pour stocker une différence potentiellement négative.
Dans l’exemple, last pointe juste après la fin du tableau de quatre éléments : last - first vaut donc 4 et first - last vaut -4. Dans l’environnement testé, le programme affiche ces valeurs sous forme décimale. Toutefois, si les octets comportent suffisamment de bits, l’implémentation peut faire de std::ptrdiff_t un alias de signed char. Dans ce cas, l’insertion directe de ces valeurs dans std::cout avec << écrit des caractères et non des nombres décimaux.
Exemples
#include <cstddef>
#include <iostream>
int main() {
int values[] = {10, 20, 30, 40};
const int* first = values;
const int* last = values + 4;
std::ptrdiff_t forward = last - first;
std::ptrdiff_t backward = first - last;
std::cout << forward << '\n' << backward << '\n';
}
Résultat
4 -4
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.