[time.cal.year] - C++17 → C++20

Files changed (1) hide show

tmp/tmpi6wr0et7/{from.md → to.md} +223 -0

tmp/tmpi6wr0et7/{from.md → to.md} RENAMED Viewed

	@@ -0,0 +1,223 @@

+### Class `year` <a id="time.cal.year">[[time.cal.year]]</a>
+#### Overview <a id="time.cal.year.overview">[[time.cal.year.overview]]</a>
+``` cpp
+namespace std::chrono {
+  class year {
+    short y_;                   // exposition only
+  public:
+    year() = default;
+    constexpr explicit year(int y) noexcept;
+    constexpr year& operator++()    noexcept;
+    constexpr year  operator++(int) noexcept;
+    constexpr year& operator--()    noexcept;
+    constexpr year  operator--(int) noexcept;
+    constexpr year& operator+=(const years& y) noexcept;
+    constexpr year& operator-=(const years& y) noexcept;
+    constexpr year operator+() const noexcept;
+    constexpr year operator-() const noexcept;
+    constexpr bool is_leap() const noexcept;
+    constexpr explicit operator int() const noexcept;
+    constexpr bool ok() const noexcept;
+    static constexpr year min() noexcept;
+    static constexpr year max() noexcept;
+  };
+}
+```
+`year` represents a year in the civil calendar. It can represent values
+in the range \[`min()`, `max()`\]. It can be constructed with any `int`
+value, which will be subsequently truncated to fit into `year`’s
+unspecified internal storage. `year` meets the *Cpp17EqualityComparable*
+([[cpp17.equalitycomparable]]) and *Cpp17LessThanComparable* (
+[[cpp17.lessthancomparable]]) requirements, and participates in basic
+arithmetic with `years` objects, which represent a difference between
+two `year` objects.
+`year` is a trivially copyable and standard-layout class type.
+#### Member functions <a id="time.cal.year.members">[[time.cal.year.members]]</a>
+``` cpp
+constexpr explicit year(int y) noexcept;
+```
+*Effects:* Initializes `y_` with `y`. The value held is unspecified if
+`y` is not in the range \[`-32767`, `32767`\].
+``` cpp
+constexpr year& operator++() noexcept;
+```
+*Effects:* `++y_`.
+*Returns:* `*this`.
+``` cpp
+constexpr year operator++(int) noexcept;
+```
+*Effects:* `++(*this)`.
+*Returns:* A copy of `*this` as it existed on entry to this member
+function.
+``` cpp
+constexpr year& operator--() noexcept;
+```
+*Effects:* `–y_`.
+*Returns:* `*this`.
+``` cpp
+constexpr year operator--(int) noexcept;
+```
+*Effects:* `–(*this)`.
+*Returns:* A copy of `*this` as it existed on entry to this member
+function.
+``` cpp
+constexpr year& operator+=(const years& y) noexcept;
+```
+*Effects:* `*this = *this + y`.
+*Returns:* `*this`.
+``` cpp
+constexpr year& operator-=(const years& y) noexcept;
+```
+*Effects:* `*this = *this - y`.
+*Returns:* `*this`.
+``` cpp
+constexpr year operator+() const noexcept;
+```
+*Returns:* `*this`.
+``` cpp
+constexpr year year::operator-() const noexcept;
+```
+*Returns:* `year{-y_}`.
+``` cpp
+constexpr bool is_leap() const noexcept;
+```
+*Returns:* `y_ % 4 == 0 && (y_ % 100 != 0 || y_ % 400 == 0)`.
+``` cpp
+constexpr explicit operator int() const noexcept;
+```
+*Returns:* `y_`.
+``` cpp
+constexpr bool ok() const noexcept;
+```
+*Returns:* `min().y_ <= y_ && y_ <= max().y_`.
+``` cpp
+static constexpr year min() noexcept;
+```
+*Returns:* `year{-32767}`.
+``` cpp
+static constexpr year max() noexcept;
+```
+*Returns:* `year{32767}`.
+#### Non-member functions <a id="time.cal.year.nonmembers">[[time.cal.year.nonmembers]]</a>
+``` cpp
+constexpr bool operator==(const year& x, const year& y) noexcept;
+```
+*Returns:* `int{x} == int{y}`.
+``` cpp
+constexpr strong_ordering operator<=>(const year& x, const year& y) noexcept;
+```
+*Returns:* `int{x} <=> int{y}`.
+``` cpp
+constexpr year operator+(const year& x, const years& y) noexcept;
+```
+*Returns:* `year{int{x} + y.count()}`.
+``` cpp
+constexpr year operator+(const years& x, const year& y) noexcept;
+```
+*Returns:* `y + x`.
+``` cpp
+constexpr year operator-(const year& x, const years& y) noexcept;
+```
+*Returns:* `x + -y`.
+``` cpp
+constexpr years operator-(const year& x, const year& y) noexcept;
+```
+*Returns:* `years{int{x} - int{y}}`.
+``` cpp
+template<class charT, class traits>
+  basic_ostream<charT, traits>&
+    operator<<(basic_ostream<charT, traits>& os, const year& y);
+```
+*Effects:* Equivalent to:
+``` cpp
+return os << (y.ok() ?
+  format(STATICALLY-WIDEN<charT>("{:%Y}"), y) :
+  format(STATICALLY-WIDEN<charT>("{:%Y} is not a valid year"), y));
+```
+``` cpp
+template<class charT, class traits, class Alloc = allocator<charT>>
+  basic_istream<charT, traits>&
+    from_stream(basic_istream<charT, traits>& is, const charT* fmt,
+                year& y, basic_string<charT, traits, Alloc>* abbrev = nullptr,
+                minutes* offset = nullptr);
+```
+*Effects:* Attempts to parse the input stream `is` into the `year` `y`
+using the format flags given in the NTCTS `fmt` as specified in
+[[time.parse]]. If the parse fails to decode a valid year,
+`is.setstate(ios_base::failbit)` is called and `y` is not modified. If
+`%Z` is used and successfully parsed, that value will be assigned to
+`*abbrev` if `abbrev` is non-null. If `%z` (or a modified variant) is
+used and successfully parsed, that value will be assigned to `*offset`
+if `offset` is non-null.
+*Returns:* `is`.
+``` cpp
+constexpr chrono::year operator""y(unsigned long long y) noexcept;
+```
+*Returns:* `year{static_cast<int>(y)}`.

Diff to HTML by rtfpessoa