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

CKTIS / C++

std::uint32_t — tipo sem sinal de largura exata de 32 bits

std::uint32_t de <cstdint> é um alias de um tipo inteiro sem sinal com exatamente 32 bits e sem bits de preenchimento. Armazena valores de 0 a 4294967295. A sua disponibilidade depende da implementação.

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

Sintaxe

#include <cstdint>
std::uint32_t value{42};

std::uint32_t, declarado em <cstdint>, é um alias de um tipo inteiro sem sinal existente, não um tipo novo e distinto. Tem exatamente 32 bits e nenhum bit de preenchimento. O seu intervalo de valores, incluindo os extremos, vai de 0 a 4294967295.

Este alias é opcional: uma implementação tem de o disponibilizar se definir um tipo inteiro com a largura correspondente e sem bits de preenchimento. Não parta do princípio de que significa sempre unsigned int. Se precisar de pelo menos 32 bits, em vez de exatamente 32, considere std::uint_least32_t.

A aritmética efetuada num tipo sem sinal de 32 bits opera módulo 2^32. Uma conversão inteira para std::uint32_t também produz o valor congruente módulo 2^32; por isso, static_cast<std::uint32_t>(-1) produz 4294967295. No entanto, isto não significa que todas as expressões com um operando desse tipo sejam avaliadas nesse tipo: as promoções inteiras e as conversões entre tipos podem alterar o tipo usado no cálculo.

O exemplo apresenta um valor comum e o resultado da conversão explícita de um inteiro negativo. Abrange regras disponíveis em C++23; o site de referência indicado apresenta um projeto de trabalho em evolução, e não uma publicação imutável de C++23.

Exemplos

#include <cstdint>
#include <iostream>

int main() {
    const std::uint32_t value{42};
    const auto wrapped = static_cast<std::uint32_t>(-1);
    std::cout << static_cast<unsigned long>(value) << '\n' << static_cast<unsigned long>(wrapped) << '\n';
}

Resultado

42
4294967295

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