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

CKTIS / C++

std::uint16_t — um inteiro sem sinal com exatamente 16 bits

std::uint16_t, de <cstdint>, é um alias opcional para um tipo inteiro sem sinal com exatamente 16 bits e um intervalo de 0 a 65535. É útil quando é necessária uma largura exata, mas não garante um tamanho de dois bytes em todas as plataformas.

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

Sintaxe

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

std::uint16_t, disponível após #include <cstdint>, é um alias de um tipo inteiro sem sinal existente, não um tipo novo e distinto. Tem exatamente 16 bits, sem bits de preenchimento, e representa valores de 0 a 65535. Não parta do princípio de que é sempre um alias de unsigned short.

Este alias é opcional: uma implementação disponibiliza-o se suportar um tipo inteiro com a largura correspondente e sem bits de preenchimento. Se forem suficientes pelo menos 16 bits, escolha std::uint_least16_t. Ter exatamente 16 bits não significa necessariamente que sizeof(std::uint16_t) == 2, pois sizeof mede bytes de C++, que não têm necessariamente 8 bits.

Converter um inteiro para std::uint16_t produz o seu valor módulo 65536; por isso, static_cast<std::uint16_t>(65536UL) produz 0. Isto não significa que todas as operações com operandos deste tipo usem aritmética de 16 bits: as promoções de inteiros podem alterar primeiro os tipos dos operandos, muitas vezes para int. Para cálculos que exijam um intervalo maior, escolha explicitamente um tipo suficientemente largo.

O exemplo mostra o valor máximo e o resultado de uma conversão explícita. As conversões para unsigned long garantem uma saída numérica, independentemente do tipo subjacente do alias. O código destina-se a ser compilado em modo C++23; a escolha desse modo, por si só, não comprova o funcionamento num ambiente de produção.

Exemplos

#include <cstdint>
#include <iostream>

int main() {
    constexpr std::uint16_t maximum{65535};
    constexpr auto wrapped = static_cast<std::uint16_t>(65536UL);
    static_assert(wrapped == 0);

    std::cout << static_cast<unsigned long>(maximum) << '\n'
              << static_cast<unsigned long>(wrapped) << '\n';
}

Resultado

65535
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