std::chrono::duration<Rep,Period>::duration

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека утилит

Языковая поддержка Поддержка типов (базовые типы, RTTI) Макросы тестирования функциональности библиотеки (C++20)     Управление динамической памятью Программные утилиты Поддержка сопрограмм (C++20) Вариативные функции is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) Трёхстороннее сравнение (C++20) three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)     is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

Общие утилиты Дата и время Функциональные объекты Библиотека форматирования (C++20) bitset hash (C++11) Операторы отношения (устарело в C++20) rel_ops::operator!=rel_ops::operator> rel_ops::operator<=rel_ops::operator>= Целочисленные функции сравнения cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)     cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Операции обмена и типа swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Общие лексические типы pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23) Элементарные преобразования строк to_chars (C++17) from_chars (C++17) chars_format (C++17) to_chars_result (C++17) from_chars_result (C++17)

 

Функции работы с датой и временем

Момент времени
time_point (C++11)	clock_time_conversion (C++20)	clock_cast (C++20)
Длительность
duration (C++11)
Часы
system_clock (C++11) steady_clock (C++11) high_resolution_clock (C++11)	is_clock (C++20) utc_clock (C++20) tai_clock (C++20)	gps_clock (C++20) file_clock (C++20) local_t (C++20)
Время суток
is_amis_pm (C++20)(C++20)	make12make24 (C++20)(C++20)	hh_mm_ss (C++20)
Календари
day (C++20) month (C++20) year (C++20) weekday (C++20) operator/ (C++20) year_month_day (C++20)	year_month_day_last (C++20) year_month_weekday (C++20) year_month_weekday_last (C++20)       weekday_indexed (C++20) weekday_last (C++20) month_day (C++20)	month_day_last (C++20) month_weekday (C++20) month_weekday_last (C++20) year_month (C++20) last_speclast (C++20)(C++20)
Часовые пояса
tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20) sys_info (C++20)	local_info (C++20) nonexistent_local_time (C++20) ambiguous_local_time (C++20) locate_zone (C++20) current_zone (C++20) time_zone (C++20) choose (C++20)	zoned_traits (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (C++20) leap_second_info (C++20) get_leap_second_info (C++20)
Ввод/Вывод chrono
parse (C++20)
Дата и время в стиле C

 

std::chrono::duration

Функции-элементы
duration::duration duration::operator= duration::count duration::zero duration::min duration::max duration::operator+duration::operator-	duration::operator++duration::operator-- duration::operator+=duration::operator-=duration::operator*=duration::operator/=duration::operator%=
Функции, не являющиеся элементами
operator+operator-operator*operator/operator% operator==operator!=operator<operator<=operator>operator>=operator<=> (до C++20)(C++20) operator<< (C++20)	duration_cast floor (C++17) ceil (C++17) round (C++17) abs (C++17) operator""h (C++14) operator""min (C++14) operator""s (C++14) operator""ms (C++14) operator""us (C++14) operator""ns (C++14) from_stream (C++20)
Вспомогательные классы
common_type treat_as_floating_point      duration_values	formatter<std::chrono::duration> (C++20) hash<std::chrono::duration> (C++26)

 

<tbody> </tbody>

constexpr duration() = default;	(1)	(начиная с C++11)
duration( const duration& ) = default;	(2)	(начиная с C++11)
template< class Rep2 > constexpr explicit duration( const Rep2& r );	(3)	(начиная с C++11)
template< class Rep2, class Period2 > constexpr duration( const duration<Rep2,Period2>& d );	(4)	(начиная с C++11)

Создаёт новый duration из одного из нескольких дополнительных источников данных.

1) Конструктор по умолчанию создаётся по умолчанию.

2) Конструктор копирования создаётся по умолчанию (делает побитовую копию счётчика тиков).

3) Создаёт duration с r тактами. Обратите внимание, что этот конструктор участвует в разрешении перегрузки только в том случае, если const Rep2& (тип аргумента) неявно преобразуется в rep (тип тиков этого duration) и

• std::chrono::treat_as_floating_point<rep>::value равно {co|true}}, или
• std::chrono::treat_as_floating_point<Rep2>::value равно {co|false}}.

(то есть duration с целым числом тактов не может быть построен из значения с плавающей запятой, но duration с числом тактов с плавающей запятой может быть построен из целочисленного значения)

4) Создаёт duration путём преобразования d в соответствующий период и количество тактов, как если бы std::chrono::duration_cast<duration>(d).count(). Чтобы предотвратить усечение во время преобразования, этот конструктор участвует в разрешении перегрузки только в том случае, если вычисление коэффициента преобразования (с помощью std::ratio_divide<Period2, Period>) не переполняется и:

• std::chrono::treat_as_floating_point<rep>::value == true

или оба:

• std::ratio_divide<Period2, period>::den == 1 и
• std::chrono::treat_as_floating_point<Rep2>::value == false.

(то есть либо duration использует тики с плавающей запятой, либо Period2 точно делится на период)

Параметры

r	—	счётчик тиков
d	—	длительность для копирования

Пример

В следующем коде показано несколько примеров (как допустимых, так и недопустимых) построения длительности:

Запустить этот код

#include <chrono>
int main()
{
    std::chrono::hours h(1); // один час
    std::chrono::milliseconds ms{3}; // 3 миллисекунды
    std::chrono::duration<int, std::kilo> ks(3); // 3000 секунд

    // ошибка: treat_as_floating_point<int>::value == false,
    // Эта длительность позволяет подсчитывать только целые тики
//  std::chrono::duration<int, std::kilo> d3(3.5);

    // Часы 30 Гц с использованием дробных тиков
    std::chrono::duration<double, std::ratio<1, 30>> hz30(3.5);

    // 3000 микросекунд, построенных из 3 миллисекунд
    std::chrono::microseconds us = ms;
    // ошибка: 1/1000000 не делится на 1/1000
//  std::chrono::milliseconds ms2 = us
    std::chrono::duration<double, std::milli> ms2 = us; // 3.0 миллисекунды
}

Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

Номер	Применён	Поведение в стандарте	Корректное поведение
LWG 3050	C++11	ограничение конвертируемости использовало неконстантное xvalue	вместо этого используются константные значения lvalue

Смотрите также

operator=

присваивает содержимое (public функция-элемент)