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

CKTIS / C++

std::chrono::duration_cast — conversion explicite de durée

std::chrono::duration_cast convertit une durée vers un type std::chrono::duration spécifié. Si la mise à l’échelle nécessite une division entière, le quotient est tronqué vers zéro après la conversion du nombre d’unités dans un type intermédiaire commun. La fonction ne vérifie pas les dépassements.

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

Syntaxe

std::chrono::duration_cast<ToDuration>(d)

La fonction std::chrono::duration_cast, déclarée dans <chrono>, renvoie une nouvelle durée sans modifier d. ToDuration doit être une spécialisation de std::chrono::duration, comme std::chrono::seconds, et non int. Le résultat est un objet durée ; utilisez .count() pour obtenir son nombre d’unités.

Si les périodes source et cible sont égales, la fonction convertit directement le nombre d’unités d’origine dans le type de représentation cible. Le fait de ne pas passer par le type intermédiaire commun peut changer les conversions appelées lorsqu’un type de représentation est un type classe. Si les périodes diffèrent, la fonction convertit d’abord le nombre d’unités d’origine dans un type intermédiaire commun, le met à l’échelle selon le rapport de la période source à la période cible, puis convertit le résultat dans le type de représentation cible. La division entière tronque le quotient vers zéro, mais elle s’applique au nombre déjà converti. Si le type intermédiaire et le type de représentation cible sont tous deux unsigned long long, la conversion de -500 millisecondes en secondes transforme -500 en une grande valeur non signée avant la division par 1000. Le résultat est donc un grand nombre positif de secondes, et non zéro. Dans l’exemple présenté, -1750 millisecondes donnent -1 seconde, et non -2. Revenir aux millisecondes ne permet pas de récupérer les 750 millisecondes perdues.

Le constructeur duration autorise certaines conversions implicites, mais bloque notamment la conversion de millisecondes entières en secondes entières. duration_cast permet de demander explicitement cette conversion. La fonction ne vérifie toutefois pas que les valeurs restent dans les limites du type : une multiplication intermédiaire peut provoquer un dépassement, et un dépassement sur un entier signé entraîne un comportement indéfini. Lors d’une conversion d’un nombre flottant en entier, évitez NaN, les infinis et les valeurs dont le résultat tronqué n’est pas représentable dans le type cible : le comportement est alors indéfini.

Exemples

#include <chrono>
#include <iostream>

int main() {
    constexpr std::chrono::milliseconds input{-1750};
    constexpr auto whole =
        std::chrono::duration_cast<std::chrono::seconds>(input);
    constexpr auto restored =
        std::chrono::duration_cast<std::chrono::milliseconds>(whole);

    static_assert(whole.count() == -1);
    static_assert(restored.count() == -1000);

    std::cout << whole.count() << '\n'
              << restored.count() << '\n';
}

Résultat

-1
-1000

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