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.