Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::uint64_t — inteiro sem sinal de 64 bits

std::uint64_t de <cstdint> é um alias opcional de um tipo inteiro sem sinal com exatamente 64 bits e sem bits de preenchimento. Armazena valores de 0 a 18446744073709551615.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <cstdint>
std::uint64_t name{value};

std::uint64_t é um alias de um tipo existente, não um tipo novo e distinto. Inclua <cstdint> e declare as variáveis como std::uint64_t name{value};. A largura exata é útil quando um formato de dados exige valores não negativos de 64 bits.

O tipo é opcional: uma implementação disponibiliza-o se tiver um tipo adequado com exatamente 64 bits e sem bits de preenchimento. A macro UINT64_MAX está disponível quando este alias existe. Não parta do princípio de que o alias corresponde sempre a unsigned long long.

O intervalo vai de 0 a 18446744073709551615, ou seja, 2^64 − 1. A aritmética efetuada no tipo std::uint64_t é feita módulo 2^64, mas as promoções de tipos inteiros podem alterar o tipo em que se efetua uma operação. Se std::uint64_t for promovido a int e INT_MAX for igual a UINT64_MAX, incrementar diretamente o valor máximo provoca um transbordo no tipo com sinal int, o que constitui comportamento indefinido. Mesmo quando o regresso a zero está bem definido, pode indicar um erro na lógica do programa. A largura exata não especifica a ordem dos bytes no armazenamento binário.

O exemplo apresenta o valor máximo, converte value para unsigned long long, adiciona 1ULL e converte o resultado de novo para std::uint64_t. A adição é efetuada num tipo sem sinal e a conversão final dá o resultado módulo 2^64, pelo que o exemplo apresenta 0. A condição #ifndef UINT64_MAX gera uma mensagem de erro clara em implementações sem este tipo opcional. A fonte citada é um projeto de norma em evolução, não uma edição C++23 imutável.

Exemplos

#include <cstdint>
#include <iostream>

#ifndef UINT64_MAX
#error "This example requires std::uint64_t"
#else
int main() {
    std::uint64_t value{UINT64_MAX};
    std::cout << static_cast<unsigned long long>(value) << '\n';
    value = static_cast<std::uint64_t>(static_cast<unsigned long long>(value) + 1ULL);
    std::cout << static_cast<unsigned long long>(value) << '\n';
}
#endif

Resultado

18446744073709551615
0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes