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

CKTIS / C++

Literais definidos pelo utilizador

Um literal definido pelo utilizador combina um literal numérico, de carácter ou de cadeia com um sufixo personalizado. O operador literal correspondente transforma essa escrita num valor, por exemplo, num objeto que representa uma distância.

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

Sintaxe

constexpr ReturnType operator""_suffix(unsigned long long value);
constexpr ReturnType operator""_suffix(long double value);
123_suffix
1.5_suffix

Um literal definido pelo utilizador (user-defined literal), como 42_m, é tratado como uma chamada a um operador literal ou a um modelo de operador literal. O sufixo faz parte da escrita do literal; não é uma operação sobre uma variável. O mecanismo abrange inteiros, números de vírgula flutuante, caracteres e cadeias; não altera o significado de sufixos integrados como LL.

Uma declaração de operador literal (literal operator declaration) utiliza um nome como operator""_m. A função pertence a um espaço de nomes, incluindo o espaço de nomes global, e a sua declaração tem de estar disponível para a pesquisa de nomes no local de utilização. Comece os sufixos personalizados por _ e evite __: os sufixos sem _ inicial estão reservados para futura normalização, enquanto os que contêm __ estão reservados às implementações.

A forma numérica que recebe um valor exige unsigned long long para um literal inteiro ou long double para um literal de vírgula flutuante, não int nem double. A forma numérica em bruto aceita const char*; também existem modelos de operador. A forma normal para cadeias recebe um apontador e um comprimento std::size_t que exclui o nulo final, enquanto a forma para caracteres recebe o tipo de carácter correspondente.

No exemplo, 42_m chama operator""_m(42ULL) e constrói um Distance. constexpr permite a verificação com static_assert; o sufixo, por si só, não garante a avaliação em tempo de compilação. O exemplo destina-se a verificação no modo C++23. O documento fornecido é um rascunho de trabalho em evolução, não uma edição definitiva de C++23.

Exemplos

#include <iostream>

struct Distance {
    unsigned long long metres;
};

constexpr Distance operator""_m(unsigned long long value) {
    return Distance{value};
}

int main() {
    constexpr auto distance = 42_m;
    static_assert(distance.metres == 42);
    std::cout << distance.metres << " m\n";
}

Resultado

42 m

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