CKTIS / C++
std::chrono::weekday — Wochentag und c_encoding()
std::chrono::weekday steht für einen Wochentag. Die Methode c_encoding() gibt unsigned zurück: Bei gültigen Werten steht 0 für Sonntag und 6 für Samstag. Prüfe ok(), bevor du Eingabewerte interpretierst.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
std::chrono::weekday{unsigned_value}
constexpr unsigned std::chrono::weekday::c_encoding() const noexcept;std::chrono::weekday steht für einen Wochentag, nicht für ein vollständiges Datum. Die Methode std::chrono::weekday::c_encoding() hat die Signatur constexpr unsigned c_encoding() const noexcept; und gibt den gespeicherten Wert zurück: Bei einem gültigen Objekt ist Sonntag 0, Montag 1 und Samstag 6.
Der Konstruktor mit einem unsigned-Wert wandelt 7 in 0 um, wendet aber kein allgemeines Modulo 7 an. Daher ist weekday{8} ungültig: ok() gibt false zurück und c_encoding() gibt 8 zurück. Bei Argumenten außerhalb von [0, 255] ist der gespeicherte Wert nicht spezifiziert. Prüfe ok(), bevor du das Ergebnis als gültigen Wochentag behandelst.
Verwechsle diese Codierung nicht mit iso_encoding(): Bei gültigen Wochentagen verwendet die ISO-Codierung 1 für Montag und 7 für Sonntag. Das Beispiel zeigt beide Codierungen für Sonntag sowie ein ungültiges Objekt, ohne eine Uhr abzufragen oder Zeitzonen zu verwenden.
Beispiele
#include <chrono>
#include <iostream>
int main() {
constexpr std::chrono::weekday sunday{7};
constexpr std::chrono::weekday monday{1};
constexpr std::chrono::weekday invalid{8};
static_assert(sunday.ok() && sunday.c_encoding() == 0);
static_assert(monday.ok() && monday.c_encoding() == 1);
static_assert(!invalid.ok() && invalid.c_encoding() == 8);
std::cout << sunday.c_encoding() << ' '
<< sunday.iso_encoding() << '\n';
std::cout << monday.c_encoding() << '\n';
std::cout << std::boolalpha << invalid.ok() << ' '
<< invalid.c_encoding() << '\n';
}
Ergebnis
0 7 1 false 8
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.