op_ostream.md

operator<<

• chrono[meta header]
• std::chrono[meta namespace]
• function[meta id-type]
• cpp20[meta cpp]

namespace std::chrono {
  template <class charT, class traits>
  std::basic_ostream<charT, traits>&
    operator<<(std::basic_ostream<charT, traits>& os,
               const year_month_weekday_last& ymwdl); // (1) C++20
}

概要

year_month_weekday_lastオブジェクトを出力ストリームに出力する。

戻り値

便宜上のリテラルキャストSTATICALLY-WIDENを導入する。STATICALLY-WIDEN<charT>("...")は、charTがcharである場合は"..."、charTがwchar_tである場合はL"..."を意味する。

• (1) : 以下と等価：

  return os << format(os.getloc(), STATICALLY-WIDEN<charT>("{:L}/{:L}/{:L}"),
                      ymwdl.year(), ymwdl.month(), ymwdl.weekday_last());

  • format[link /reference/format/format.md]
  • os.getloc()[link /reference/ios/ios_base/getloc.md]
  • ymwdl.year()[link year.md]
  • ymwdl.month()[link month.md]
  • ymwdl.weekday_last()[link weekday_last.md]

例

#include <iostream>
#include <chrono>

namespace chrono = std::chrono;
using namespace std::chrono_literals;

int main()
{
  std::cout << 2020y/3/chrono::Sunday[chrono::last] << std::endl;
}

• 2020y[link /reference/chrono/year/op_y.md]
• chrono::Sunday[link /reference/chrono/weekday_constants.md]
• chrono::last[link /reference/chrono/last_spec.md]

出力

2020/Mar/Sun[last]

バージョン

言語

• C++20

処理系

• Clang: 9.0 [mark noimpl]
• GCC: 9.2 [mark noimpl]
• Visual C++: 2019 Update 3 [mark noimpl]

関連項目

• chronoのstd::format() (フォーマットの詳細)

参照

• P2372R1 Fixing locale handling in chrono formatters
  • この提案文書はC++20の策定後に採択されたが、実装が追いついていない時期の採択だったために、C++20の仕様として扱われる