std::chrono...hrono::year)(3)

💖 NAME 💖

hey bestie!! welcome to the std::chrono::operator==,(std::chrono::year) page 💖 this one lives in the C++ Standard Libary manual (yes, that's the exact spelling in the header — we respect the source, no cap 💅), and the header title is literally std::chrono...hrono::year)(3).

The NAME line, in all its duplicated glory: std::chrono::operator==,(std::chrono::year) — std::chrono::operator==,(std::chrono::year).

so yeah, the page is about std::chrono::operator==,(std::chrono::year), and the source says the name twice. iconic behavior. periodt. ✨

🎀 Synopsis 🎀

Defined in header <chrono>. 💖

// (1) (since C++20)
constexpr bool operator==( const std::chrono::year& x,
                           const std::chrono::year& y ) noexcept;

// (2) (since C++20)
constexpr std::strong_ordering operator<=>( const std::chrono::year& x,
                                            const std::chrono::year& y ) noexcept;

okay so this literally compares the two std::chrono::year values x and y. that's the whole task. 🦋

The <, <=, >, >=, and != operators are synthesized from operator<=> and operator== respectively. (iykyk: the comparison squad comes built in. ✨)

🌸 Return value 🌸

1. int(x) == int(y)
2. int(x) <=> int(y)

fr fr, overload (1) hands you int(x) == int(y), and overload (2) hands you int(x) <=> int(y). simple, slay, done. 💅

🦋 Example 🦋

// Run this code

#include <chrono>
#include <iostream>

int main()
{
    using namespace std::chrono;

    constexpr year y1{2020};
    constexpr year y2{2021};

    std::cout << std::boolalpha << (y1 != y2) << '\n';

    static_assert((2020y < 2023y) && (2020y == 2020y) && (2020y <= 2023y) &&
                  (2023y > 2020y) && (2023y != 2020y) && (2023y >= 2020y));
}

⭐ Output ⭐

true

💖 source: http://cppreference.com · version/date: 2024.06.10 · footer title: std::chrono...hrono::year)(3) — bye bestie, go compare those years and slay! 🎀✨💅