Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::nano — le rapport d’un milliardième

std::nano est un alias de type de <ratio> qui représente exactement le facteur 1/1 000 000 000. Il fournit le numérateur num et le dénominateur den sous forme de constantes utilisables à la compilation ; ce n’est ni un nombre à virgule flottante ni une unité de temps.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

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

std::nano, déclaré dans <ratio>, est un alias de std::ratio<1, 1'000'000'000>. Il désigne le facteur exact 10⁻⁹, soit un milliardième, correspondant au préfixe SI nano. C’est un type, et non une fonction ou un objet contenant une valeur à virgule flottante.

Les membres std::nano::num et std::nano::den sont des constantes statiques constexpr de type intmax_t. Leurs valeurs sont respectivement 1 et 1'000'000'000. Vous pouvez les utiliser dans des expressions constantes, par exemple avec static_assert, sans construire d’objet.

Le rapport seul ne définit pas d’unité : std::nano ne signifie pas automatiquement nanosecondes. Le sens de l’unité doit découler du contexte d’utilisation. Attention à la division std::nano::num / std::nano::den : les deux opérandes sont des entiers, donc le résultat est 0, et non le nombre à virgule flottante 10⁻⁹.

L’exemple vérifie le numérateur et le dénominateur à la compilation, puis les affiche séparés par /. Il n’effectue pas de division, ce qui permet au texte de conserver la représentation exacte du rapport.

Exemples

#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';
}

Résultat

1/1000000000

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources