Spec-Zone.ru › C++

std::chrono::operator<<(std::chrono::year)

Определено в заголовочном файле <chrono>
template< class CharT, class Traits >
std::basic_ostream<CharT, Traits>&
    operator<<( std::basic_ostream<CharT, Traits>& os, const std::chrono::year& y );
(с C++20)

Формирует std::basic_string<CharT> s, содержащий значение года, хранящееся в y, отформатированное как десятичное число, дополненное слева ​0​ до четырёх цифр, если в противном случае результат будет иметь менее четырёх цифр. Затем, если !y.ok(), добавляет " is not a valid year" к отформатированной строке. Вставляет эту строку в os.

Эквивалентно

return os << (y.ok() ?
std::format(STATICALLY_WIDEN<CharT>("{:%Y}"), y) :
std::format(STATICALLY_WIDEN<CharT>("{:%Y} is not a valid year"), y));

где STATICALLY_WIDEN<CharT>("...") — "...", если CharT — char, и L"...", если CharT — wchar_t.

Результат

os

Пример

#include <chrono>
#include <iostream>
 
int main()
{
    constexpr std::chrono::year y1{2020}, y2{-020}, y3{98304};
    std::cout << y1 << '\n'
              << y2 << '\n'
              << y3 << '\n';
}

Возможный вывод:

2020
-0016
-32768 is not a valid year

См. также

format
(C++20)
хранит отформатированное представление аргументов в новой строке
(шаблон функции)
std::formatter<std::chrono::year>
(C++20)
поддержка форматирования для year
(специализация шаблона класса)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/chrono/year/operator_ltlt

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API