std::chrono::ambiguous_local_time

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Datums- und Zeitbibliothek

Zeitpunkt time_point (C++11) clock_time_conversion (C++20)   clock_cast (C++20) Dauer duration (C++11) Uhren system_clock (C++11) steady_clock (C++11) is_clock (C++20) utc_clock (C++20) tai_clock (C++20) high_resolution_clock (C++11) gps_clock (C++20) file_clock (C++20) local_t (C++20) Tageszeit is_amis_pm (C++20)(C++20) make12make24 (C++20)(C++20) hh_mm_ss (C++20)

Kalender day (C++20) month (C++20) year (C++20) weekday (C++20) operator/ (C++20) year_month_day (C++20) year_month_day_last (C++20) year_month_weekday (C++20) year_month_weekday_last (C++20)   weekday_indexed (C++20) weekday_last (C++20) month_day (C++20) month_day_last (C++20) month_weekday (C++20) month_weekday_last (C++20) year_month (C++20) last_speclast (C++20)(C++20) chrono E/A parse (C++20)

Zeitzone tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20) sys_info (C++20) local_info (C++20) nonexistent_local_time (C++20) ambiguous_local_time (C++20) locate_zone (C++20) current_zone (C++20) time_zone (C++20) choose (C++20) zoned_traits (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (C++20) leap_second_info (C++20) get_leap_second_info (C++20) C-Stil Datums- und Zeitfunktionen

 

Definiert in Header <chrono>
class ambiguous_local_time;		(seit C++20)

Definiert einen Objekttyp, der als Ausnahme ausgelöst wird, um zu melden, dass versucht wurde, eine mehrdeutige std::chrono::local_time in eine std::chrono::sys_time zu konvertieren, ohne eine std::chrono::choose (wie z.B. choose::earliest oder choose::latest) anzugeben.

Diese Ausnahme wird von std::chrono::time_zone::to_sys und Funktionen, die sie aufrufen (wie die Konstruktoren von std::chrono::zoned_time, die eine std::chrono::local_time entgegennehmen), ausgelöst.

Vererbungdiagramm

Member-Funktionen

(Konstruktor)	konstruiert das Ausnahmeobjekt (öffentliche Memberfunktion)
operator=	ersetzt das Ausnahmeobjekt (öffentliche Memberfunktion)
what	gibt den erklärenden String zurück (öffentliche Memberfunktion)

std::chrono::ambiguous_local_time::ambiguous_local_time

template< class Duration > ambiguous_local_time( const std::chrono::local_time<Duration>& tp,                       const std::chrono::local_info& i );	(1)	(seit C++20)
ambiguous_local_time( const ambiguous_local_time& other ) noexcept;	(2)	(seit C++20)

Konstruiert das Ausnahmeobjekt.

1) Der von what() zurückgegebene erklärende String ist äquivalent zu dem, der von os.str() nach dem folgenden Code erzeugt wird

std::ostringstream os;
os << tp << " is ambiguous.  It could be\n"
   << tp << ' ' << i.first.abbrev << " == "
   << tp - i.first.offset << " UTC or\n"
   << tp << ' ' << i.second.abbrev  << " == "
   << tp - i.second.offset  << " UTC";

Das Verhalten ist undefiniert, wenn i.result != std::chrono::local_info::ambiguous.

2) Kopierkonstruktor. Wenn *this und other beide den dynamischen Typ std::chrono::ambiguous_local_time haben, dann ist std::strcmp(what(), other.what()) == 0.

Parameter

tp	-	der Zeitpunkt, für den die Konvertierung versucht wurde
i	-	ein std::chrono::local_info, das das Ergebnis des Konvertierungsversuchs beschreibt
Sonstiges	-	ein anderer ambiguous_local_time zum Kopieren

Ausnahmen

Kann std::bad_alloc auslösen

Anmerkungen

Da das Kopieren einer Standardbibliotheksklasse, die von std::exception abgeleitet ist, keine Ausnahmen auslösen darf, wird diese Nachricht typischerweise intern als separat zugeordneter referenzgekoppelter String gespeichert.

std::chrono::ambiguous_locale_time::operator=

ambiguous_locale_time& operator=( const ambiguous_locale_time& other ) noexcept;		(seit C++20)

Weist den Inhalt mit dem von other zu. Wenn *this und other beide den dynamischen Typ std::chrono::ambiguous_locale_time haben, dann ist std::strcmp(what(), other.what()) == 0 nach der Zuweisung.

Parameter

Sonstiges

-

ein anderes Ausnahmeobjekt zum Zuweisen

Rückgabewert

*this

std::chrono::ambiguous_locale_time::what

virtual const char* what() const noexcept;		(seit C++20)

Gibt den erklärenden String zurück.

Rückgabewert

Zeiger auf einen implementierungsdefinierten, nullterminierten String mit erläuternden Informationen. Der String kann für die Konvertierung und Anzeige als std::wstring verwendet werden. Der Zeiger ist garantiert gültig, mindestens bis das Ausnahmeobjekt, von dem er stammt, zerstört wird, oder bis eine nicht-const Memberfunktion (z. B. der Kopierzuweisungsoperator) für das Ausnahmeobjekt aufgerufen wird.

Der zurückgegebene String ist während der konstanten Auswertung mit der gewöhnlichen Literal-Codierung kodiert.

(seit C++26)

Anmerkungen

Implementierungen dürfen what() überschreiben, sind aber nicht dazu verpflichtet.

Geerbt von std::runtime_error

Abgeleitet von std::exception

Memberfunktionen

(Destruktor) [virtuell]	zerstört das Ausnahmeobjekt (virtuelle öffentliche Memberfunktion von std::exception)
what [virtuell]	gibt einen erklärenden String zurück (virtuelle öffentliche Memberfunktion von std::exception)

Siehe auch

nonexistent_local_time (C++20)

Ausnahme, die geworfen wird, um zu melden, dass eine Lokalzeit nicht existiert (Klasse)