CKTIS / C++
Sufixo `u` dos literais inteiros sem sinal
O sufixo `u` ou `U` seleciona um tipo inteiro sem sinal, mas não fixa a sua largura. `0u` e `1u` são `unsigned int`; um valor maior pode exigir um tipo mais largo.
Versão: ISO C++23; implementation support may vary
Sintaxe
integer-literal ::= (binary-literal | octal-literal | decimal-literal | hexadecimal-literal) integer-suffix?
unsigned-suffix ::= u | U
Examples: 0u, 1U, 0b101u, 077u, 0xFFU, 42ul, 42lu, 42ull, 42llu, 42uz, 42zuEm C++23, escreve u ou U imediatamente após os algarismos de um literal inteiro. O sufixo não altera o valor e funciona com literais decimais, binários, octais e hexadecimais. Quando usado sozinho, seleciona o primeiro tipo capaz de representar o valor: unsigned int, unsigned long e, por fim, unsigned long long. Se nenhum servir, a implementação pode usar um tipo inteiro estendido sem sinal adequado. Se nenhum tipo permitido puder representar o valor, o programa é malformado: o literal não é truncado.
0u e 1u são sempre do tipo unsigned int; 0 e 1 sem sufixo são do tipo int. ul começa a procura em unsigned long, ull seleciona unsigned long long entre os tipos padrão e uz dá std::size_t em C++23 se o valor for representável. u pode também aparecer depois do outro componente do sufixo, como em lu, llu ou zu.
As constantes do FNV de 32 bits, 2166136261u e 16777619u, são ambas do tipo unsigned int quando esse tipo tem 32 bits. Noutras implementações, a seleção depende dos intervalos dos tipos. O sufixo não significa std::uint32_t: este é um alias opcional de <cstdint> para um tipo inteiro sem sinal de exatamente 32 bits, sem bits de preenchimento. Se precisares de um objeto desse tipo exato e o alias estiver disponível, escreve, por exemplo, std::uint32_t offset{2166136261u};. O tipo do objeto não altera o tipo do literal usado para o inicializar.
O tipo do literal influencia a dedução com auto, a resolução de sobrecargas e as conversões em expressões. Por exemplo, -1 < 1u dá false: -1 é convertido em unsigned int e passa a ser o valor máximo desse tipo. Não acrescentes u só para silenciar um aviso sobre a mistura de tipos com e sem sinal.
Exemplos
#include <iostream>
#include <type_traits>
constexpr const char* kind(int) { return "int"; }
constexpr const char* kind(unsigned int) { return "unsigned int"; }
int main() {
auto zero = 0u;
static_assert(std::is_same_v<decltype(zero), unsigned int>);
static_assert(std::is_same_v<decltype(1u), unsigned int>);
std::cout << kind(1) << '\n'
<< kind(1u) << '\n';
}Resultado
int unsigned int
As asserções verificam o tipo deduzido por `auto` a partir de `0u` e o tipo de `1u`. `kind(1)` e `kind(1u)` escolhem sobrecargas diferentes porque há uma correspondência exata de tipos em cada caso.
Lições relacionadas
- C++ · Lição 7 · Avançado · Versão: 3
Fontes
- N4950 — Working Draft, Standard for Programming Language C++, §5.13.2 [lex.icon]
- Integer literals [lex.icon]
- Header <cstdint> synopsis [cstdint.syn]
- Fundamental types [basic.fundamental]
- Usual arithmetic conversions [expr.arith.conv]
- Integral conversions [conv.integral]
- Placeholder type specifiers [dcl.spec.auto]
- Ranking implicit conversion sequences [over.ics.rank]