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

CKTIS / C++

Declaração de operadores de literais em C++

Declare os sufixos personalizados `_KiB`, `_MiB` e `_pct`. Veja como a forma do literal determina o operador e por que razão `ULL` e o menos unário funcionam de outro modo.

Versão: ISO C++23; implementation support may vary

Sintaxe

namespace units {
    constexpr unsigned long long operator ""_KiB(unsigned long long n);
    constexpr unsigned long long operator ""_MiB(unsigned long long n);
    constexpr long double operator ""_pct(long double n);
}

// In the scope that uses the literals:
using units::operator ""_KiB;
using units::operator ""_MiB;
using units::operator ""_pct;
// Example expressions: 2_KiB, 1_MiB, -25.0_pct

Uma declaração como constexpr unsigned long long operator ""_KiB(unsigned long long n); declara a função chamada por 2_KiB. Declare-a no âmbito de um espaço de nomes e escreva o sufixo imediatamente após o número. A pesquisa do nome é não qualificada: using units::operator ""_KiB; disponibiliza a declaração no ponto de utilização. _KiB, _MiB e _pct são sufixos personalizados, não da biblioteca padrão. Comece os seus sufixos com _ e não use __ em nenhuma posição.

Um operador numérico da forma cooked recebe o valor, e não a grafia no código-fonte. As formas inteiras dão prioridade a um parâmetro unsigned long long: 2_KiB é tratado como operator ""_KiB(2ULL). ULL é um sufixo inteiro incorporado, que não pode ser sobrecarregado; não o combine com _KiB. As formas de vírgula flutuante dão prioridade a long double: 25.0_pct é tratado como operator ""_pct(25.0L).

Sem a sobrecarga cooked correspondente, a pesquisa tem de encontrar exactamente uma de duas alternativas: um operador raw com const char* ou um modelo de operador de literal numérico com um pacote template<char...>. Ambas recebem a grafia no código-fonte, e não o valor numérico. Com apenas a sobrecarga long double, 25_pct é malformado: tem forma inteira e não recorre à sobrecarga de vírgula flutuante por conversão.

Em -25.0_pct, o menos está fora do literal: aplica-se ao valor devolvido, não ao argumento. Em -2_KiB, o resultado mantém o tipo unsigned long long e segue a aritmética modular, em vez de se tornar um número negativo de bytes. Para calcular tamanhos, verifique n <= max / factor antes de multiplicar, em que max é o máximo do tipo do resultado; o exemplo omite esta verificação. As funções devolvem números por valor, e constexpr permite a avaliação em tempo de compilação sem a exigir em todas as chamadas. Os literais definidos pelo utilizador existem desde C++11; esta entrada descreve C++23 e o suporte pode variar consoante a implementação.

Exemplos

#include <iomanip>
#include <iostream>

namespace units {
constexpr unsigned long long operator ""_KiB(unsigned long long n) {
    return n * 1024ULL;
}

constexpr unsigned long long operator ""_MiB(unsigned long long n) {
    return n * 1048576ULL;
}

constexpr long double operator ""_pct(long double n) {
    return n / 100.0L;
}
}

int main() {
    using units::operator ""_KiB;
    using units::operator ""_MiB;
    using units::operator ""_pct;

    static_assert(2_KiB == 2048ULL);
    static_assert(1_MiB == 1048576ULL);
    static_assert(-25.0_pct < 0.0L);

    std::cout << 2_KiB << '\n'
              << 1_MiB << '\n'
              << std::fixed << std::setprecision(2) << -25.0_pct << '\n';
}

Resultado

2048
1048576
-0.25

O programa apresenta o número de bytes para `2_KiB` e `1_MiB` e, em seguida, `-25.0_pct` como uma fracção com duas casas decimais.

Lições relacionadas

  • C++ · Lição 60 · Avançado · Versão: 3

Fontes