Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::chrono::duration_cast — jawna konwersja czasu trwania

std::chrono::duration_cast przelicza czas trwania na wskazany typ std::chrono::duration. Jeśli skalowanie wymaga dzielenia całkowitoliczbowego, iloraz jest obcinany w kierunku zera po konwersji liczby jednostek na wspólny typ pośredni. Funkcja nie sprawdza przepełnienia.

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

Składnia

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

Funkcja std::chrono::duration_cast z nagłówka <chrono> zwraca nowy czas trwania, nie zmieniając d. Parametr ToDuration musi być specjalizacją std::chrono::duration, np. std::chrono::seconds, a nie typem int. Wynik jest obiektem czasu trwania; jego liczbę jednostek odczytuje się przez .count().

Jeśli okresy źródłowy i docelowy są równe, funkcja rzutuje źródłową liczbę jednostek bezpośrednio na typ reprezentacji celu. Pominięcie wspólnego typu pośredniego może wpłynąć na to, które konwersje zostaną wywołane, gdy typ reprezentacji jest typem klasowym. Jeśli okresy się różnią, funkcja najpierw konwertuje źródłową liczbę jednostek na wspólny typ pośredni, skaluje ją według stosunku okresu źródłowego do docelowego, a następnie konwertuje wynik na typ reprezentacji celu. Dzielenie całkowitoliczbowe obcina iloraz w kierunku zera, ale działa już na wartości po konwersji. Jeśli zarówno typ pośredni, jak i typ reprezentacji celu to unsigned long long, przy przeliczaniu -500 milisekund na sekundy wartość -500 staje się dużą wartością bez znaku jeszcze przed dzieleniem przez 1000. Wynikiem jest więc duża dodatnia liczba sekund, a nie zero. W pokazanym przykładzie -1750 milisekund daje -1 sekundę, nie -2. Ponowne przeliczenie na milisekundy nie odzyska utraconych 750 milisekund.

Konstruktor duration dopuszcza niektóre konwersje niejawne, lecz blokuje m.in. przejście z całkowitych milisekund na całkowite sekundy. duration_cast pozwala jawnie zażądać takiej konwersji. Nie jest jednak kontrolą zakresu: mnożenie pośrednie może przepełnić typ, a przepełnienie typu całkowitego ze znakiem oznacza niezdefiniowane zachowanie. Przy konwersji zmiennoprzecinkowej do całkowitej unikaj NaN, nieskończoności i wartości, których obcięty wynik nie mieści się w typie docelowym — zachowanie jest wtedy niezdefiniowane.

Przykłady

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

Wynik

-1
-1000

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła