std::chrono...::operator-=(3)

💖 NAME 💖

Welcome to std::chrono...::operator-=(3), bestie! This page covers std::chrono::year::operator+= and std::chrono::year::operator-= — the NAME line serves them as std::chrono::year::operator+=,std::chrono::year::operator-= and then repeats std::chrono::year::operator+=,std::chrono::year::operator-= after the dash. Periodt. It’s from the C++ Standard Libary manual (yes, “Libary” — the typo is canon, don’t come for me 💀).

---

🌸 Synopsis 🌸

Here’s the signature tea, verbatim, because we do not mess with code:

          constexpr std::chrono::year& operator+=( const std::chrono::years&
       (1) (since C++20)
          y ) noexcept;
          constexpr std::chrono::year& operator-=( const std::chrono::years&
       (2) (since C++20)
          y ) noexcept;

In human: it adds or subtracts y.count() years from the year value. 🦋

1. (1) — Equivalent to *this = *this + y;.
2. (2) — Equivalent to *this = *this - y;.

---

🫶 Return value 🫶

You get back a reference to this year after modification. Like it hands you the same lil’ object, all updated and ready. 🫶

---

🧚 Notes 🧚

If the result would be outside the range [-32767, 32767], the actual stored value is unspecified.

No cap, that’s literally what the page says. ⚠️

---

💅 Example 💅

The page says // Run this code, and then serves this exact code:

        #include <chrono>
        #include <iostream>

        int main()
        {
            using namespace std::literals::chrono_literals;
            std::cout << std::boolalpha;

            std::chrono::year y{2020};

            y += std::chrono::years(12);
            std::cout << (y == 2032y) << ' ';

            y -= std::chrono::years(33);
            std::cout << (y == 1999y) << '\n';
        }

---

🌈 Output: 🌈

It outputs exactly:

true true

---

👑 See also 👑

• operator++
• operator++(int) — increments or decrements the year
• operator-- — (public member function)
• operator--(int)
• operator+ — performs arithmetic on years
• operator- — (function)
• (C++20)

---

Cute sign-off: this page came from http://cppreference.com, dated 2024.06.10, and it’s std::chrono...::operator-=(3). Bye bestie, go slay some years! 💖✨