std::chrono::operator<< (std::chrono::duration)

来自cppreference.com
< cpp‎ | chrono‎ | duration
 
C++
 
日期和时间库
时间点
(C++11)
(C++20)  
(C++20)
时长
(C++11)
时钟
(C++11)
(C++11)
(C++20)
(C++20)
(C++20)
(C++11)
(C++20)
(C++20)
(C++20)
当天时刻
(C++20)(C++20)
(C++20)(C++20)
(C++20)
日历
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)  
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)(C++20)
chrono I/O
(C++20)

 
std::chrono::duration
成员函数
非成员函数
(C++17)
(C++17)
(C++17)
(C++17)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++20)

辅助类
 
在标头 <chrono> 定义
template<

    class CharT,
    class Traits,
    class Rep,
    class Period
> std::basic_ostream<CharT, Traits>&
    operator<<( std::basic_ostream<CharT, Traits>& os,

                const std::chrono::duration<Rep, Period>& d );
 (C++20 起)

插入 d 的文本表示到 os 中。

表现如同它实现为 

std::basic_ostringstream<CharT, Traits> s;
s.flags(os.flags());
s.imbue(os.getloc());
s.precision(os.precision());
s << d.count() << units_suffix; // 见后述
return os << s.str();

换言之，流标志、本地环境和精度由流确定，但用整个输出字符串确定任何填充。

units_suffix 基于按照下表的 Period::type 确定。

Period::type 后缀
std::atto as
std::femto fs
std::pico ps
std::nano ns
std::micro µs (U+00B5) 或 us，使用何者是实现定义的
std::milli ms
std::centi cs
std::deci ds
std::ratio<1> s
std::deca das
std::hecto hs
std::kilo ks
std::mega Ms
std::giga Gs
std::tera Ts
std::peta Ps
std::exa Es
std::ratio<60> min
std::ratio<3600> h
std::ratio<86400> d
非以上之一，且 Period::type::den == 1 [num]s
非以上之一 [num/den]s

对于表中最后二行，后缀中的 num 和 den 分别是 Period::type::num 和 Period::type::den 格式化为不带前导零十进制数。

[编辑] 返回值

流的引用，即 os。

[编辑] 示例

此示例展示给定时长时 std::chrono::operator<< 的输出。

运行此代码
#include <chrono>
#include <iostream>
using namespace std::chrono_literals;
 
int main()
{
    constexpr auto duration = 123ms;
    std::cout << duration << '\n';
}

输出： 

123ms

[编辑] 参阅

(C++20)
 在新字符串中存储参数的格式化表示
(函数模板) [编辑]
(C++20)
 duration 的格式化支持
(类模板特化) [编辑]
执行字符串的流输入与输出
(函数模板) [编辑]
(C++11)
 转换整数或浮点数为 string
(函数) [编辑]
(C++11)
 转换整数或浮点数为 wstring
(函数) [编辑]
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/chrono/duration/operator_ltlt&oldid=81753”