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

Spezialisierung von std::formatter , die Formatierungsregeln für eine std::chrono::duration definiert. Die duration wird als Tageszeit seit Mitternacht interpretiert.

Die std::formatter Spezialisierung wird normalerweise nicht direkt aufgerufen, sondern wird über Formatierungsfunktionen verwendet.

Formatspezifikation

Die Formatspezifikation hat die Form

fill-and-align , width und precision haben dieselbe Bedeutung wie in der Standard-Format-Spezifikation . precision ist nur gültig für std::chrono::duration -Typen, bei denen der Repräsentationstyp Rep ein Gleitkommatyp ist, andernfalls wird std::format_error ausgelöst.

Das für die Formatierung verwendete Gebietsschema wird wie folgt bestimmt:

• die Standard-Lokalisierung "C" falls L nicht in der Formatangabe vorhanden ist,
• andernfalls die durch das std::locale angegebene Lokalisierung, falls eines an die Formatierungsfunktion übergeben wurde,
• andernfalls ( L ist vorhanden, aber kein std::locale wurde an die Formatierungsfunktion übergeben) die globale Lokalisierung.

Wenn die (gewöhnliche oder breite) String-Literal-Kodierung eine Unicode-Kodierungsform ist und das Gebietsschema zu einem implementierungsdefinierten Satz von Gebietsschemata gehört, wird jeder ersetzende Vorgang, der vom Gebietsschema abhängt, so durchgeführt, als ob die Ersatzzeichenfolge in die Literalkodierung konvertiert würde.

Die chrono-spec besteht aus einem oder mehreren Konvertierungsspezifizierern und gewöhnlichen Zeichen (außer { , } und % ). Eine chrono-spec muss mit einem Konvertierungsspezifizierer beginnen. Alle gewöhnlichen Zeichen werden unverändert in die Ausgabe geschrieben. Jeder unmodifizierte Konvertierungsspezifizierer beginnt mit einem % -Zeichen, gefolgt von einem Zeichen, das das Verhalten des Spezifizierers bestimmt. Einige Konvertierungsspezifizierer haben eine modifizierte Form, bei der ein E - oder O -Modifikatorzeichen nach dem % -Zeichen eingefügt wird. Jeder Konvertierungsspezifizierer wird wie unten beschrieben durch entsprechende Zeichen in der Ausgabe ersetzt.

Sofern nicht anders angegeben, wird das Chrono-Objekt, wenn die chrono-spec leer ist, so formatiert, als würde es durch Streaming an ein Objekt os vom Typ std:: basic_ostringstream < CharT > mit der Formatierungs-Locale (entweder std:: locale :: classic ( ) , das übergebene std::locale -Objekt oder std:: locale :: global ( ) ) imbuiert und durch Kopieren von os. str ( ) in den Ausgabepuffer mit zusätzlichem Padding und Anpassungen gemäß den Format-Spezifizierern ausgegeben.

Die folgenden Formatbezeichner sind verfügbar:

Die folgenden Spezifizierer werden erkannt, führen jedoch dazu, dass std::format_error ausgelöst wird:

Beispiel

#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

Siehe auch