std:: formatter <std::chrono::duration>

Spécialisation de std::formatter qui définit les règles de formatage pour une std::chrono::duration . La duration est interprétée comme l'heure de la journée depuis minuit.

La spécialisation std::formatter n'est généralement pas accédée directement, mais est utilisée via les fonctions de formatage .

Spécification du format

La spécification de format a la forme

fill-and-align , width , et precision ont la même signification que dans la spécification de format standard . precision n'est valide que pour les types std::chrono::duration où le type de représentation Rep est un type à virgule flottante, sinon std::format_error est levée.

La locale utilisée pour le formatage est déterminée comme suit :

• la locale par défaut "C" si L n'est pas présente dans la spécification de format,
• sinon, la locale désignée par le std::locale passé à la fonction de formatage, s'il y en a un,
• sinon ( L est présent mais aucun std::locale n'est passé à la fonction de formatage), la locale globale.

Si l' encodage des littéraux de chaîne (ordinaire ou large) est une forme de codage Unicode et que la locale fait partie d'un ensemble défini par l'implémentation de locales, chaque remplacement dépendant de la locale est effectué comme si la séquence de caractères de remplacement était convertie vers l'encodage du littéral.

La chrono-spec consiste en un ou plusieurs spécificateurs de conversion et des caractères ordinaires (autres que { , } , et % ). Une chrono-spec doit commencer par un spécificateur de conversion. Tous les caractères ordinaires sont écrits en sortie sans modification. Chaque spécificateur de conversion non modifié commence par un caractère % suivi d'un caractère qui détermine le comportement du spécificateur. Certains spécificateurs de conversion ont une forme modifiée dans laquelle un caractère modificateur E ou O est inséré après le caractère % . Chaque spécificateur de conversion est remplacé par les caractères appropriés en sortie comme décrit ci-dessous.

Sauf indication contraire, si la chrono-spec est vide, l'objet chrono est formaté comme s'il était streamé vers un objet os de type std:: basic_ostringstream < CharT > avec les paramètres régionaux de formatage (l'un des std:: locale :: classic ( ) , l'objet std::locale passé, et std:: locale :: global ( ) ) appliqués et en copiant os. str ( ) dans le tampon de sortie avec un remplissage et des ajustements supplémentaires selon les spécificateurs de format.

Les spécificateurs de format suivants sont disponibles :

Les spécificateurs suivants sont reconnus, mais entraîneront std::format_error à être levé :

Exemple

#include <chrono>
#include <print>
using namespace std::chrono_literals;
int main()
{
    auto du{3h + 2min + 1s};
    std::print(
        "Duration is:\n"
        "{}\n"
        "{:%T}\n"
        "{:%H:%M:%S}\n"
        "{:%H hours %M minutes %S seconds}\n",
        du, du, du, du);
}

Duration is:
10921s
03:02:01
03:02:01
03 hours 02 minutes 01 seconds

Voir aussi