Класс duration

Измеряет интервал времени, например одну минуту, два часа, десять миллисекунд и т. д.

Содержит duration интервал времени, который является числом тиков за единицу времени. Например, пять минут составляет пять галок, с каждым тиком в минуту друг от друга. 42 секунды — 42 галочки, каждый из которых за секунду раздается.

Синтаксис

template <class Rep, class Period> class duration;
template <class Rep, class Period = ratio<1>> class duration;
template <class Rep, class Period1, class Period2> class duration <duration<Rep, Period1>, Period2>;

Замечания

Аргумент шаблона Rep описывает тип, используемый для удержания числа тактов в интервале. Аргумент Period шаблона — это экземпляр ratio , описывающий размер интервала, который представляет каждый галок.

Участники

Конструкторы

Функции

Операторы

Не являющиеся членами

Шаблоны функций

Операторы

Псевдонимы удобных типов

Требования

Заголовок: <chrono>

Пространство имен: std::chrono

duration::count

Получает количество тактов в интервале времени.

constexpr Rep count() const;

Возвращаемое значение

Количество тактов в интервале времени.

Конструктор duration::duration

Формирует объект duration.

1) constexpr duration() = default;
2) constexpr duration(const duration& d) = default;

3) template <class Rep2>
constexpr explicit duration(const Rep2& R);

4) template <class Rep2, class Period2>
constexpr duration(const duration<Rep2, Period2>& Dur);

Параметры

Dur
Количество тактов в периоде, указанном в Period2.

Period2
Специализация шаблона std::ratio для представления тактового периода в секундах.

R
Количество тактов в периоде по умолчанию.

Rep2
Арифметический тип для представления числа тактов.

Замечания

1) Конструктор по умолчанию создает объект, который неинициализирован. Инициализация значения с помощью пустых фигурных скобок инициализирует объект, представляющий интервал времени нулевых тактов.

2) Конструктор копирования делает побитовую копию d.

3) Создает объект, представляющий интервал времени часов, R используя период std::ratio<1>по умолчанию. Чтобы избежать округления чисел, это ошибка, чтобы создать объект длительности из типа Rep2 представления, который можно рассматривать как тип с плавающей запятой, когда duration::rep нельзя рассматривать как тип с плавающей запятой.

4) Создает объект, представляющий интервал времени, длина которого — интервал времени, указанный в параметре Dur. Чтобы избежать усечения счетчиков галок, это ошибка, чтобы создать объект длительности из другого объекта длительности, тип которого является несовместимым с целевым типом.

Тип D1 длительности несовместим с другим типом D2 длительности, если D2 его нельзя рассматривать как тип с плавающей запятой и ratio_divide<D1::p eriod, D2::p eriod>::type::d en не равен 1.

Если неявно rep преобразуется в иtreat_as_floating_point<rep> содержит значение true или treat_as_floating_point<Rep2>содержит значение false, второй конструктор не участвует в разрешении перегрузки.Rep2 Дополнительные сведения см. в type_traits><.

Если при преобразовании не вызывается переполнение и treat_as_floating_point<rep>имеет значение true, либо ratio_divide<Period2, period>::den оба равно 1 и treat_as_floating_point<Rep2>содержат значение false, третий конструктор не участвует в разрешении перегрузки. Дополнительные сведения см. в type_traits><.

Пример. Создание duration

// compile using: /std:c++latest
#include <iostream>
#include <chrono>

using namespace std::chrono;

int main()
{
    // create a duration that tracks ticks as 1/10ths of a second
    duration<int, std::ratio<1, 10>> tenths{ 5 };
    std::cout << tenths << '\n';

    hours h{12}; // hours is a convenience duration typedef 
    auto h2 = 3h; // 'h' is a convenience operator. h2 is a duration<int, std::ratio<3600,1>>

    std::cout << h << ":" << h2 << '\n';

    return 0;
}

5ds
3h:3h

duration::max

Статический метод, который возвращает верхнюю границу значений типа параметра-шаблона Rep.

static constexpr duration max();

Возвращаемое значение

Фактически возвращает duration(duration_values<rep>::max()).

duration::min

Статический метод, который возвращает нижнюю границу значений типа параметра-шаблона Rep.

static constexpr duration min();

Возвращаемое значение

Фактически возвращает duration(duration_values<rep>::min()).

duration::operator-

Возвращает копию duration объекта с отрицанием числа галок.

constexpr duration operator-() const;

duration::operator--

Уменьшает на единицу накопленный счетчик тактов.

1) duration& operator--();
2) duration operator--(int);

Возвращаемое значение

1) Возвращает *this. 2) Возвращает копию *this до уменьшения.

duration::operator%=

Уменьшает хранимый счетчик галок по модуле указанного значения.

1) duration& operator%=(const rep& Div);
2) duration& operator%=(const duration& Div);

Параметры

Div
1) Div число галок. 2) Div значение duration , содержащее число галок.

Возвращаемое значение

Объект duration после выполнения операции модуля.

duration::operator*=

Умножает накопленный счетчик тактов на указанное значение.

duration& operator*=(const rep& Mult);

Параметры

Mult
Значение типа, которое задается параметром duration::rep.

Возвращаемое значение

Объект duration после умножения выполняется.

duration::operator/=

Делит накопленный счетчик тактов на указанное значение.

duration& operator/=(const rep& Div);

Параметры

Div
Значение типа, которое задается параметром duration::rep.

Возвращаемое значение

Объект duration после завершения деления.

duration::operator+

Возвращает *this.

constexpr duration operator+() const;

Возвращаемое значение

*this

duration::operator++

Увеличивает на единицу накопленный счетчик тактов.

1) duration& operator++();
2) duration operator++(int);

Возвращаемое значение

1) Возвращает *this. 2) Возвращает копию *this до увеличения.

duration::operator+=

Добавляет счетчик тактов указанного объекта duration к накопленному счетчику тактов.

duration& operator+=(const duration& Dur);

Параметры

Dur
Объект duration.

Возвращаемое значение

Объект duration после добавления.

duration::operator-=

Вычитает счетчик тактов указанного объекта duration из накопленного счетчика тактов.

duration& operator-=(const duration& Dur);

Параметры

Dur
Объект duration.

Возвращаемое значение

Объект duration после завершения вычитания.

duration::zero

Возвращает duration(duration_values<rep>::zero()).

static constexpr duration zero();

duration::operator=

Назначает одну длительность другой.

duration& operator=(const duration &other) = default;

Параметры

other
Копируемый объект duration.

Возвращаемое значение

Объект LHS duration .

См. также

<chrono>
Удобные duration типдефы, такие как minutes, secondsи многое другое
Удобные литералы в течение часов, минут и многое другое
Структура duration_values
Справочник по файлам заголовков