Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::chrono::weekday — jour de la semaine et c_encoding()

std::chrono::weekday représente un jour de la semaine. Sa méthode c_encoding() renvoie un unsigned : pour les valeurs valides, 0 désigne le dimanche et 6 le samedi. Vérifiez ok() avant d’interpréter les valeurs d’entrée.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

std::chrono::weekday{unsigned_value}
constexpr unsigned std::chrono::weekday::c_encoding() const noexcept;

std::chrono::weekday représente un jour de la semaine, et non une date complète. La méthode std::chrono::weekday::c_encoding() a la signature constexpr unsigned c_encoding() const noexcept; et renvoie la valeur stockée : pour un objet valide, le dimanche vaut 0, le lundi 1 et le samedi 6.

Le constructeur qui prend un unsigned convertit 7 en 0, mais n’applique pas un modulo 7 général. Ainsi, weekday{8} est invalide : ok() renvoie false et c_encoding() renvoie 8. Pour les arguments en dehors de [0, 255], la valeur stockée n’est pas spécifiée. Vérifiez ok() avant de considérer le résultat comme un jour de la semaine valide.

Ne confondez pas cet encodage avec iso_encoding() : pour les jours valides, l’encodage ISO utilise 1 pour le lundi et 7 pour le dimanche. L’exemple montre les deux encodages du dimanche ainsi qu’un objet invalide, sans consulter d’horloge ni utiliser de fuseaux horaires.

Exemples

#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';
}

Résultat

0 7
1
false 8

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources