Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::chrono::weekday — dia da semana e c_encoding()

std::chrono::weekday representa um dia da semana. O método c_encoding() devolve unsigned: para valores válidos, 0 significa domingo e 6 sábado. Verifique ok() antes de interpretar os valores de entrada.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

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

std::chrono::weekday representa um dia da semana, não uma data completa. O método std::chrono::weekday::c_encoding() tem a assinatura constexpr unsigned c_encoding() const noexcept; e devolve o valor armazenado: para um objeto válido, domingo é 0, segunda-feira 1 e sábado 6.

O construtor que recebe um unsigned converte 7 em 0, mas não aplica um módulo 7 geral. Assim, weekday{8} é inválido: ok() devolve false e c_encoding() devolve 8. Para argumentos fora de [0, 255], o valor armazenado não é especificado. Verifique ok() antes de tratar o resultado como um dia da semana válido.

Não confunda esta codificação com iso_encoding(): para os dias válidos, a codificação ISO usa 1 para segunda-feira e 7 para domingo. O exemplo mostra ambas as codificações de domingo e um objeto inválido, sem consultar um relógio nem utilizar fusos horários.

Exemplos

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

Resultado

0 7
1
false 8

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes