std::chrono::year::ok(3)

💖 std::chrono::year::ok 💖

okay so this page comes from the C++ Standard Libary manual (yes, that spelling, no cap), and the whole vibe is checking whether a std::chrono::year is valid. It’s giving tiny validity-checker main character energy. 💅

---

✨ NAME ✨

std::chrono::year::ok — literally std::chrono::year::ok. That’s the name, bestie, we’re not doing extra.

---

🌸 Synopsis 🌸

constexpr bool ok() const noexcept;

✨ since C++20 ✨

This checks if the year value stored in *this is in the valid range, i.e. [-32767, 32767]. That’s the whole assignment, and it ate. 🔥

---

💅 Return value 💅

It gives you true if the year value stored in *this is in the range [-32767, 32767]. Otherwise? false. That’s it. No secret lore. 🫶

---

🧚 Possible implementation 🧚

See the implementations in libstdc++, libc++, and Howard Hinnant's date.h.

class Year
{
    short year_;   // exposition-only

public:

    bool ok() const noexcept { return year_ != std::numeric_limits<short>::min(); }

    /*...*/
};

---

🍓 Example 🍓

🎀 // Run this code — go off, bestie:

#include <chrono>
#include <iomanip>
#include <iostream>

int main()
{
    std::cout << "input year │ internal value │ ok()\n" <<
        std::boolalpha;

    for (const int i : {2020, 0x8000, 0x8001, 0xFFFF, 0x18000})
    {
        const std::chrono::year y{i};
        std::cout << std::setw(10) << i << " │ "
                  << std::setw(14) << static_cast<int>(y) << " │ "
                  << y.ok() << '\n';
    }
}

---

🌈 Possible output 🌈

fr fr it can print like this:

input year │ internal value │ ok()
      2020 │           2020 │ true
     32768 │         -32768 │ false
     32769 │         -32767 │ true
     65535 │             -1 │ true
     98304 │         -32768 │ false

---

okay that’s the page 💖 source/version + date check: http://cppreference.com, 2024.06.10, and the page is std::chrono::year::ok(3) — mwah 💋