WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::uintptr_t — ein Integer-Typ zum Speichern eines Zeigerwerts

std::uintptr_t aus <cstdint> ist ein vorzeichenloser Integer-Typ, mit dem sich ein gültiger void* in eine Zahl und zurück umwandeln lässt, ohne den Zeigerwert zu verlieren. In C++23 ist der Typ optional; er legt weder eine feste Breite noch ein portables Adressformat fest.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <cstdint>

std::uintptr_t bits = reinterpret_cast<std::uintptr_t>(ptr);
void* restored = reinterpret_cast<void*>(bits);

std::uintptr_t aus <cstdint> ist ein Alias für einen vorzeichenlosen Integer-Typ. Er ermöglicht, einen gültigen void* in eine Zahl und anschließend zurück in einen void* umzuwandeln, der mit dem ursprünglichen Zeiger vergleicht. In C++23 ist dieser Typ optional; seine Verfügbarkeit lässt sich nach dem Einbinden des Headers mit #if defined(UINTPTR_MAX) prüfen. Der angegebene Verweis führt zum fortlaufend weiterentwickelten Arbeitsentwurf, der diesen Typ inzwischen vorschreibt — diese Anforderung gilt nicht rückwirkend für C++23.

Führe die Umwandlungen ausdrücklich mit reinterpret_cast aus. Die Zuordnung von Zeigern zu Ganzzahlen ist implementationsabhängig: Der Name verspricht weder genau 32 oder 64 Bit noch dieselbe Größe wie void*. Übertrage die Garantie für void* nicht auf Funktionszeiger oder Zeiger auf Member.

Wird die Ganzzahl unverändert beibehalten und der Zeiger rekonstruiert, verlängert das nicht die Lebensdauer des Objekts. Die Ganzzahl zu verändern ist kein portabler Ersatz für Zeigerarithmetik und garantiert keinen Zeiger, der sicher verwendet werden kann. Behandle diese Ganzzahl nicht als dauerhafte Adresse, die über Programmläufe hinweg gespeichert werden kann.

Das Beispiel wandelt void* in std::uintptr_t und zurück um, solange das lokale Objekt noch existiert. Es gibt das Vergleichsergebnis aus, statt eine von der jeweiligen Ausführung abhängige Zahl auszugeben, die die Adresse darstellt. Die erwartete Ausgabe ist bei verfügbarem Typ true; andernfalls gibt das Programm std::uintptr_t unavailable aus.

Beispiele

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

Ergebnis

true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen