std::chrono::tzdb_list(3)

📦
version 16.2.1+r23+gd564253eb6c8 · 10 versions
, in arch rolling, fedora 44

✨ std::chrono::tzdb_list ✨

okay bestie, sit down, hydrate, because we're about to talk about time zone databases 💖. This little page comes straight out of the Library Functions Manual (libstdc++, no cap), and it's all about std::chrono::tzdb_list. Yes it's a mouthful. Yes it's iconic. Let's go 🦋

🌸 NAME 🌸

std::chrono::tzdb_list — literally the list of chrono::tzdb objects, and she's serving main character energy ✨

🌈 SYNOPSIS 🌈

#include <chrono>

🎀 Classes 🎀

  • class const_iterator — yes, she has her own iterator class, we stan 👑

🧚 Public Member Functions 🧚

  • tzdb_list (const tzdb_list &)=delete — copying? not allowed, deleted, blocked, goodbye 🙈
  • const_iterator begin () const noexcept — iterator to the front of the list, noexcept so she's chill about it
  • const_iterator cbegin () const noexcept — const version of begin(), same energy, noexcept
  • const_iterator cend () const noexcept — const version of end(), noexcept
  • const_iterator end () const noexcept — iterator past the end of the list, noexcept
  • const_iterator erase_after (const_iterator __p) — remove the element after the one your iterator points at 👀
  • const tzdb & front () const noexcept — grab the current tzdb at the front of the list, noexcept
  • tzdb_list & operator= (const tzdb_list &)=delete — assignment? also deleted. she does not do copies, periodt 💅

💜 Friends 💜

  • bool __detail::__recent_leap_second_info (leap_second_info &, unsigned)
  • const tzdb & get_tzdb ()
  • tzdb_list & get_tzdb_list ()
  • class leap_second
  • const tzdb & reload_tzdb ()
  • struct time_zone::_Impl
  • class time_zone_link
  • struct tzdb

💫 DETAILED DESCRIPTION 💫

The list of chrono::tzdb objects 🌍

A single object of this type is constructed by the C++ runtime, and can be accessed by calling chrono::get_tzdb_list().

The front of the list is the current tzdb object and can be accessed via chrono::get_tzdb_list().front() or chrono::get_tzdb() or *chronoget_tzdb_list().begin().

The chrono::reload_tzdb() function will check for a newer version and if found, insert it at the front of the list. 🆕✨

Since C++20

🔥 MEMBER FUNCTION DOCUMENTATION 🔥

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

Remove the tzdb object after the one the iterator refers to. bye girl 👋

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). ⚠️ like, be careful bestie, this is the dangerous part.

Parameters

  • __p — A dereferenceable iterator.

Returns

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

Since C++20

References erase_after().

Referenced by erase_after().

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

Access the current tzdb at the front of the list. it's giving ✨ the main event ✨

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. 🤖 no human wrote this, and honestly? she still ate.

and that's the whole page, bestie 🫶 this one shipped from the libstdc++ source, and the footer had no date on it — she's timeless, an icon, a legend, and she is literally the manual page std::chrono::tzdb_list(3). mwah 💅💖

📦 where this page comes from