std::chrono:: parse

Gibt ein Objekt manip eines nicht näher spezifizierten Typs zurück, sodass für ein std:: basic_istream < CharT, Traits > -Objekt is der Ausdruck is >> manip from_stream (unqualifiziert, um argumentabhängige Namenssuche zu ermöglichen) wie folgt aufruft:

Der Ausdruck is >> manip ist ein L-Wert vom Typ std:: basic_istream < CharT, Traits > mit dem Wert is .

Diese Überladungen nehmen nur dann an der Überladungsauflösung teil, wenn der entsprechende from_stream Ausdruck wohlgeformt ist.

Implementierungen wird empfohlen, die Verwendung potenziell hängender Referenzen auf die Formatzeichenfolge zu erschweren, z.B. durch nicht bewegliche Rückgabetypen und durch Verhinderung, operator >> lvalues von Rückgabetypen zu akzeptieren.

Parameter

Formatzeichenkette

Der Formatstring besteht aus null oder mehr Konvertierungsspezifizierern und gewöhnlichen Zeichen. Jedes gewöhnliche Zeichen, mit Ausnahme von Leerzeichen und dem abschließenden Nullzeichen, entspricht einem identischen Zeichen aus dem Eingabestrom oder führt dazu, dass die Funktion fehlschlägt, wenn das nächste Zeichen im Strom nicht gleich ist.

Jedes Leerzeichen-Zeichen passt auf null oder mehr Leerzeichen-Zeichen im Eingabestrom.

Jeder unveränderte 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. Einige Konvertierungsspezifizierer haben eine modifizierte Form, bei der ein Breitenparameter, angegeben als positive dezimale Ganzzahl (dargestellt als N unten), nach dem % Zeichen eingefügt wird. Jeder Konvertierungsspezifizierer bewirkt, dass die übereinstimmenden Zeichen gemäß der nachstehenden Tabelle als Teile von Datums- und Zeittypen interpretiert werden.

Eine Zeichenfolge im Formatstring, die mit einem % beginnt, aber nicht mit einem der unten aufgeführten Konvertierungsspezifizierer übereinstimmt, wird als gewöhnliche Zeichen interpretiert.

Wenn from_stream nicht alles parsen kann, was durch die Formatzeichenfolge spezifiziert ist, oder wenn unzureichende Informationen geparst werden, um ein vollständiges Ergebnis zu spezifizieren, oder wenn das Parsen widersprüchliche Informationen offenbart, is. setstate ( std:: ios_base :: failbit ) wird aufgerufen.

Die folgenden Konvertierungsspezifizierer sind verfügbar:

Beispiel

#include <chrono>
#include <iostream>
#include <locale>
#include <sstream>
int main()
{
    auto parse = [&](auto str, auto fmt, auto o)
    {
        std::istringstream is{str};
        is.imbue(std::locale("en_US.utf-8"));
        is >> std::chrono::parse(fmt, o);
        is.fail() ? std::cout << "Parse failed!\n" : std::cout << o << '\n';
    };
    parse("01:02:03", "%H:%M:%S", std::chrono::hours{});
    parse("01:02:03", "%H:%M:%S", std::chrono::minutes{});
    parse("01:02:03", "%H:%M:%S", std::chrono::seconds{});
}

1h
62min
3723s

Fehlerberichte

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

Siehe auch