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

CKTIS / C++

std::nano — a razão de um milésimo de milionésimo

std::nano é um alias de tipo de <ratio> que representa o fator exato 1/1 000 000 000. Disponibiliza o numerador num e o denominador den como constantes disponíveis em tempo de compilação; não é um número de vírgula flutuante nem uma unidade de tempo.

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

Sintaxe

#include <ratio>
using nano = std::ratio<1, 1'000'000'000>; // declaration inside namespace std

std::nano, declarado em <ratio>, é um alias de std::ratio<1, 1'000'000'000>. Representa o fator exato 10⁻⁹, ou seja, um milésimo de milionésimo, correspondente ao prefixo SI nano. É um tipo, não uma função nem um objeto que contenha um valor de vírgula flutuante.

Os membros std::nano::num e std::nano::den são constantes estáticas constexpr do tipo intmax_t. Os respetivos valores são 1 e 1'000'000'000. Podem ser usados em expressões constantes, como static_assert, sem criar um objeto.

A razão, por si só, não especifica uma unidade: std::nano não significa automaticamente nanossegundos. O significado da unidade tem de resultar do contexto de utilização. Atenção à divisão std::nano::num / std::nano::den: ambos os operandos são inteiros, pelo que o resultado é 0, e não o número de vírgula flutuante 10⁻⁹.

O exemplo verifica o numerador e o denominador em tempo de compilação e, em seguida, apresenta-os separados por /. Não efetua a divisão, pelo que o texto preserva a representação exata da razão.

Exemplos

#include <iostream>
#include <ratio>

int main() {
    static_assert(std::nano::num == 1);
    static_assert(std::nano::den == 1'000'000'000);

    std::cout << std::nano::num << '/' << std::nano::den << '\n';
}

Resultado

1/1000000000

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