База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::uintptr_t — целочислен тип за съхраняване на стойност на указател

std::uintptr_t от <cstdint> е целочислен тип без знак, който позволява валиден void* да се преобразува в цяло число и обратно, без да се губи стойността на указателя. В C++23 типът е незадължителен и не задава фиксирана ширина или преносим формат на адреса.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#include <cstdint>

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

std::uintptr_t от <cstdint> е псевдоним за целочислен тип без знак. Той позволява валиден void* да се преобразува в цяло число и след това обратно в void*, който при сравнение е равен на първоначалния указател. В C++23 този тип е незадължителен; проверете наличността му с #if defined(UINTPTR_MAX) след включване на заглавния файл. Посочената препратка води към развиващия се работен проект на стандарта, който вече изисква този тип — не прилагайте това изискване със задна дата към C++23.

Извършвайте преобразуванията изрично с reinterpret_cast. Съответствието между указател и цяло число се определя от имплементацията: името не гарантира точно 32 или 64 бита, нито същия размер като void*. Не разширявайте гаранцията за void* до указатели към функции или указатели към членове.

Запазването на цялото число непроменено и възстановяването на указателя не удължава времето на живот на обекта. Промяната на цялото число не е преносим заместител на аритметиката с указатели и не гарантира указател, който може да се използва безопасно. Не третирайте това цяло число като постоянен адрес за съхраняване между стартирания на програмата.

Примерът преобразува void* в std::uintptr_t и обратно, докато локалният обект все още съществува. Той отпечатва резултата от сравнението, вместо цяло число, представящо адреса и зависещо от конкретното изпълнение. Ако типът е наличен, очакваният изход е true; в противен случай програмата отпечатва std::uintptr_t unavailable.

Примери

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

Резултат

true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници