Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::chrono::duration_cast — conversione esplicita di una durata

std::chrono::duration_cast converte una durata nel tipo std::chrono::duration specificato. Se il ridimensionamento richiede una divisione intera, il quoziente viene troncato verso zero dopo la conversione del numero di unità in un tipo intermedio comune. La funzione non controlla gli overflow.

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

Sintassi

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

La funzione std::chrono::duration_cast, dichiarata in <chrono>, restituisce una nuova durata senza modificare d. ToDuration deve essere una specializzazione di std::chrono::duration, come std::chrono::seconds, e non int. Il risultato è un oggetto durata; usa .count() per ottenere il numero di unità.

Se i periodi di origine e destinazione coincidono, la funzione converte il numero di unità di origine direttamente nel tipo di rappresentazione di destinazione. Saltare il tipo intermedio comune può cambiare quali conversioni vengono invocate quando un tipo di rappresentazione è un tipo classe. Se i periodi differiscono, la funzione converte dapprima il numero di unità di origine in un tipo intermedio comune, lo scala in base al rapporto tra il periodo di origine e quello di destinazione e infine converte il risultato nel tipo di rappresentazione di destinazione. La divisione intera tronca il quoziente verso zero, ma opera sul valore già convertito. Se sia il tipo intermedio sia quello di rappresentazione di destinazione sono unsigned long long, nel convertire -500 millisecondi in secondi il valore -500 diventa un valore elevato senza segno prima della divisione per 1000. Il risultato è quindi un numero elevato e positivo di secondi, non zero. Nell’esempio mostrato, -1750 millisecondi diventano -1 secondo, non -2. La conversione di ritorno in millisecondi non può recuperare i 750 millisecondi persi.

Il costruttore duration consente alcune conversioni implicite, ma blocca, tra le altre, la conversione da millisecondi interi a secondi interi. duration_cast permette di richiedere esplicitamente questa conversione. Tuttavia, non controlla l’intervallo: una moltiplicazione intermedia può andare in overflow e l’overflow di un intero con segno causa comportamento indefinito. Nella conversione da virgola mobile a intero, evita NaN, infinito e valori il cui risultato troncato non è rappresentabile nel tipo di destinazione: in questi casi il comportamento è indefinito.

Esempi

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

Risultato

-1
-1000

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti