std:: formatter <std::chrono::hh_mm_ss>

Spezialisierung von std::formatter , die Formatierungsregeln für einen std::chrono::hh_mm_ss definiert.

Die std::formatter Spezialisierung wird normalerweise nicht direkt aufgerufen, sondern ü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 bezeichnete Lokalisierung, falls eine 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 ob es durch Streaming in 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 würde.

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 <format>
#include <iostream>
using namespace std::literals;
int main()
{
    std::chrono::hh_mm_ss c{16h + 32min + 10s};
    std::cout << "%R: " << std::format("{:%R}", c) << '\n'
              << "%T: " << std::format("{:%T}", c) << '\n';
}

%R: 16:32
%T: 16:32:10

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch