std::time_get<CharT,InputIt>:: get, std::time_get<CharT,InputIt>:: do_get

Im Körper der Schleife finden die folgenden Schritte statt:

Zuerst löscht es die Fehlerbits in err durch Ausführung von err = std:: ios_base :: goodbit . Liest dann Zeichen aus der Eingabesequenz [ beg, end ) , die durch den std::time_get Format-Spezifizierer erwartet werden, gebildet durch Kombination von '%' , modifier (falls nicht ' \0 ' ), und format . Wenn die Zeichen keine gültige Konvertierungs-Spezifikation bilden, setzt es failbit in err . Wenn das Ende des Eingabestroms nach dem Lesen eines Zeichens erreicht wird, setzt es eofbit in err . Wenn die Eingabezeichenkette erfolgreich geparst wurde, aktualisiert es die entsprechenden Felder von * t .

Für komplexe Konvertierungsspezifizierer, wie '%x' oder '%c' , oder für Direktiven, die die Modifikatoren 'E' und 'O' verwenden, kann die Funktion möglicherweise einige der Werte nicht bestimmen, die in * t gespeichert werden sollen. In einem solchen Fall setzt sie eofbit in err und belässt diese Felder in einem nicht spezifizierten Zustand.

Parameter

Die Formatzeichenfolge besteht aus null oder mehr Konvertierungsspezifizierern, Leerzeichen und gewöhnlichen Zeichen (außer % ). Von jedem gewöhnlichen Zeichen wird erwartet, dass es genau ein Zeichen im Eingabestrom bei Groß-/Kleinschreibung-ignorierendem Vergleich entspricht. Jedes Leerzeichen entspricht beliebigem Leerraum in der Eingabezeichenfolge. Jede Konvertierungsspezifikation beginnt mit dem % -Zeichen, optional gefolgt von einem E - oder O -Modifizierer (wird ignoriert, wenn vom Locale nicht unterstützt), gefolgt von dem Zeichen, das das Verhalten der Spezifizierung bestimmt. Die Formatspezifizierer entsprechen der POSIX-Funktion strptime() :

Hinweis: tm_isdst wird nicht beschrieben und muss explizit gesetzt werden für die Verwendung mit Funktionen wie mktime

Rückgabewert

Iterator, der auf eine Position nach dem letzten erfolgreich geparsten Zeichen in [ beg, end ) zeigt.

Hinweise

Der Groß-/Kleinschreibung-ignorierende Vergleich für die Nicht-Leerzeichen-, Nicht- '%' -Zeichen in der Formatzeichenfolge verwendet typischerweise, aber nicht zwingend, die std::collate -Facette der durch str bereitgestellten Locale.

Wenn ein Parsing-Fehler auftritt, lassen viele Implementierungen dieser Funktion * t vollständig unverändert.

Es ist nicht spezifiziert, ob diese Funktionen die Felder in * t auf Null setzen, die sie nicht direkt setzen: portable Programme sollten jedes Feld vor dem Aufruf von get() auf Null initialisieren.

Beispiel

#include <iomanip>
#include <iostream>
#include <locale>
#include <sstream>
int main()
{
    std::istringstream ss("2026-März-12 23:45:56");
    ss.imbue(std::locale("de_DE.utf8"));
    auto& f = std::use_facet<std::time_get<char>>(ss.getloc());
    std::tm t{};
    std::string s = "%Y-%b-%d %H:%M:%S";
    std::ios_base::iostate err = std::ios_base::goodbit;
    auto ret = f.get({ss}, {}, ss, err, &t, &s[0], &s[0] + s.size());
    ss.setstate(err);
    std::istreambuf_iterator<char> last{};
    if (ss)
    {
        std::cout << "Erfolgreich geparst als " << std::put_time(&t, "%c") << '\n';
        if (ret != last)
        {
            std::cout << "Verbleibender Inhalt: ";
            std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout));
        }
        else
            std::cout << "Die Eingabe wurde vollständig verarbeitet.";
    }
    else
    {
        std::cout << "Parsen fehlgeschlagen.\nUngeparster String: ";
        std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout));
    }
    std::cout << '\n';
}

Successfully parsed as Sun Mar 12 23:45:56 2026
The input was fully consumed.

Siehe auch