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

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, 42zu

Em 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