CKTIS / C++
std::uintptr_t — un type entier pour stocker une valeur de pointeur
std::uintptr_t, défini dans <cstdint>, est un type entier non signé qui permet de convertir un void* valide en entier puis de le reconvertir sans perdre la valeur du pointeur. Il est facultatif en C++23 et ne définit ni largeur fixe ni format d’adresse portable.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cstdint>
std::uintptr_t bits = reinterpret_cast<std::uintptr_t>(ptr);
void* restored = reinterpret_cast<void*>(bits);std::uintptr_t, défini dans <cstdint>, est un alias d’un type entier non signé. Il permet de convertir un void* valide en entier, puis de le reconvertir en un void* qui se compare comme égal au pointeur d’origine. En C++23, ce type est facultatif ; vérifiez sa disponibilité avec #if defined(UINTPTR_MAX) après avoir inclus l’en-tête. La référence fournie mène au projet de norme en évolution, qui exige désormais ce type — ne transposez pas cette exigence à C++23.
Effectuez explicitement les conversions avec reinterpret_cast. La correspondance entre pointeur et entier est définie par l’implémentation : le nom ne garantit ni exactement 32 ou 64 bits, ni une taille identique à celle de void*. N’étendez pas la garantie relative à void* aux pointeurs de fonction ou aux pointeurs vers des membres.
Conserver l’entier inchangé et reconstruire le pointeur ne prolonge pas la durée de vie de l’objet. Modifier l’entier ne constitue pas un remplacement portable de l’arithmétique des pointeurs et ne garantit pas un pointeur utilisable en toute sécurité. Ne considérez pas cet entier comme une adresse permanente à enregistrer d’une exécution du programme à l’autre.
L’exemple convertit void* en std::uintptr_t, puis inversement, tant que l’objet local existe encore. Il affiche le résultat de la comparaison plutôt qu’un entier représentant l’adresse, qui dépendrait de l’exécution. Si le type est disponible, la sortie attendue est true ; sinon, le programme affiche std::uintptr_t unavailable.
Exemples
#include <cstdint>
#include <iostream>
int main() {
#if defined(UINTPTR_MAX)
int value = 42;
void* original = &value;
std::uintptr_t bits = reinterpret_cast<std::uintptr_t>(original);
void* restored = reinterpret_cast<void*>(bits);
std::cout << std::boolalpha << (restored == original) << '\n';
#else
std::cout << "std::uintptr_t unavailable\n";
#endif
}
Résultat
true
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.