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_pctUma 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