std::chrono::tzdb_list(3cxx)

💖 NAME 💖

std::chrono::tzdb_list — okay bestie, welcome to the std::chrono::tzdb_list(3cxx) manual page from libstdc++. This is the whole vibe for the list of chrono::tzdb objects. 💅

✨ SYNOPSIS ✨

#include <chrono>

🎀 Classes 🎀

• class const_iterator — the one class listed here, and yes it’s exactly this.

🌸 Public Member Functions 🌸

• tzdb_list (const tzdb_list &)=delete — yep, this exact signature is marked =delete.
• const_iterator begin () const noexcept — the begin iterator, with noexcept.
• const_iterator cbegin () const noexcept — the cbegin iterator, with noexcept.
• const_iterator cend () const noexcept — the cend iterator, with noexcept.
• const_iterator end () const noexcept — the end iterator, with noexcept.
• const_iterator erase_after (const_iterator __p) — erase-after, takes a const_iterator __p; full tea is below.
• const tzdb & front () const noexcept — front access, returns const tzdb &, with noexcept.
• tzdb_list & operator= (const tzdb_list &)=delete — assignment is deleted, periodt.

🦋 Friends 🦋

• const tzdb & get_tzdb () — friend.
• tzdb_list & get_tzdb_list () — friend.
• class leap_second — friend class.
• const tzdb & reload_tzdb () — friend.
• struct time_zone::_Impl — friend struct.
• class time_zone_link — friend class.
• struct tzdb — friend struct.

🌈 DETAILED DESCRIPTION 🌈

It’s the list of chrono::tzdb objects. Exactly that. A single object of this type is constructed by the C++ runtime, and you can access it by calling chrono::get_tzdb_list().

The front of the list is the current tzdb object, and you can get to it via chrono::get_tzdb_list().front() or chrono::get_tzdb() or *chronoget_tzdb_list().begin(). Iykyk. 🦋

The chrono::reload_tzdb() function will check for a newer version and if found, insert it at the front of the list. Newer tzdb sliding into the front? Slay. ✨

Since — C++20.

👑 MEMBER FUNCTION DOCUMENTATION 👑

🎀 const_iterator std::chrono::tzdb_list::erase_after (const_iterator __p) 🎀

This one removes the tzdb object after the one the iterator refers to. 💅

Calling this function concurrently with any of front(), begin(), or end() does not cause a data race, but in general this function is not thread-safe. The behaviour may be undefined if erasing an element from the list while another thread is calling the same function, or incrementing an iterator into the list, or accessing the element being erased (unless it is accessed through an iterator).

⚠️ Thread-safety tea, bestie: no data race when called concurrently with front(), begin(), or end(), but in general this function is not thread-safe. Undefined behaviour may happen in those listed cases, so don’t treat it like a free-for-all. 😭

Parameters — __p: A dereferenceable iterator.

Returns — An iterator to the element after the one that was erased (or end() if there is no such element).

Since — C++20.

🌸 const tzdb & std::chrono::tzdb_list::front () const [noexcept] 🌸

Access the current tzdb at the front of the list. This returns a reference to the same object as chrono::get_tzdb().

Returns — A reference to the current tzdb object.

Since — C++20.

💜 AUTHOR 💜

Generated automatically by Doxygen for libstdc++ from the source code.

---

Source/version: libstdc++. Page: std::chrono::tzdb_list(3cxx). Date: not listed in this footer, so no fake date, periodt. That’s the cute sign-off, bestie — mwah, and go enjoy those tzdb vibes. 💖✨🫶