CKTIS / C++
std::uint16_t — un intero senza segno di esattamente 16 bit
std::uint16_t di <cstdint> è un alias opzionale per un tipo intero senza segno di esattamente 16 bit, con un intervallo da 0 a 65535. È utile quando serve una larghezza esatta, ma non garantisce una dimensione di due byte su ogni piattaforma.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <cstdint>
std::uint16_t value{42};std::uint16_t, disponibile dopo #include <cstdint>, è un alias di un tipo intero senza segno esistente, non un nuovo tipo distinto. Ha esattamente 16 bit, senza bit di padding, e rappresenta valori da 0 a 65535. Non dare per scontato che sia sempre un alias di unsigned short.
Questo alias è opzionale: un’implementazione lo fornisce se supporta un tipo intero della larghezza corrispondente e senza bit di padding. Se bastano almeno 16 bit, scegli std::uint_least16_t. Esattamente 16 bit non significa necessariamente che sizeof(std::uint16_t) == 2, perché sizeof misura i byte C++, che non devono necessariamente contenere 8 bit.
La conversione di un intero in std::uint16_t produce il suo valore modulo 65536; quindi static_cast<std::uint16_t>(65536UL) produce 0. Questo non significa che ogni operazione con operandi di questo tipo usi l’aritmetica a 16 bit: le promozioni intere possono prima modificare i tipi degli operandi, spesso in int. Per i calcoli che richiedono un intervallo maggiore, scegli esplicitamente un tipo sufficientemente ampio.
L’esempio mostra il valore massimo e il risultato di una conversione esplicita. Le conversioni a unsigned long garantiscono un output numerico indipendentemente dal tipo sottostante dell’alias. Il codice è destinato alla compilazione in modalità C++23; la sola scelta di questa modalità non attesta il funzionamento in un ambiente di produzione.
Esempi
#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';
}
Risultato
65535 0
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.