std::chrono::from_stream (std::chrono::month)
| Definiert in Header <chrono> |
||
| template< class CharT, class Traits, class Alloc = std::allocator<CharT> > std::basic_istream<CharT, Traits>& |
(seit C++20) | |
Versucht, den Eingabestrom is gemäß der Formatzeichenfolge fmt in das std::chrono::month m zu parsen.
Verhält sich wie eine UnformattedInputFunction, mit der Ausnahme, dass sie einen nicht spezifizierten Effekt auf is.gcount() hat. Nach der Konstruktion und Überprüfung des Sentry-Objekts wird versucht, den Eingabestrom is gemäß der Formatzeichenfolge fmt in m zu parsen. Wenn das Parsen keinen gültigen month dekodieren kann, wird is.setstate(std::ios_base::failbit) aufgerufen und m nicht modifiziert.
Wenn der Formatbezeichner %Z verwendet und erfolgreich geparst wird, wird der geparste Wert *abbrev zugewiesen, wenn abbrev nicht null ist. Wenn der Formatbezeichner %z oder eine modifizierte Variante verwendet und erfolgreich geparst wird, wird der geparste Wert *offset zugewiesen, wenn offset nicht null ist.
Inhalt |
[bearbeiten] Parameter
| ist | - | ein Eingabestrom |
| fmt | - | eine Formatzeichenkette (siehe unten) |
| m | - | Objekt zur Aufnahme des Parse-Ergebnisses |
| abbrev | - | wenn nicht null, Zeiger auf ein Objekt, das die Zeitzonenkürzel oder den Namen im Zusammenhang mit dem %Z-Spezifizierer aufnehmen wird |
| offset | - | wenn nicht null, Zeiger auf ein Objekt, das den Offset von UTC im Zusammenhang mit dem %z-Spezifizierer aufnehmen wird |
[bearbeiten] Formatierungsstring
Die Formatzeichenkette besteht aus null oder mehr Konvertierungsspezifizierern und normalen Zeichen. Jedes normale Zeichen, ausgenommen Leerzeichen und das abschließende Nullzeichen, passt zu einem identischen Zeichen aus dem Eingabestrom oder führt zum Fehlschlagen der Funktion, wenn das nächste Zeichen im Strom nicht gleich ist.
Jedes Leerzeichen passt zu null oder mehr Leerzeichen 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, der als positive Dezimalzahl angegeben ist (nachfolgend als N gezeigt), nach dem %-Zeichen eingefügt wird. Jeder Konvertierungsspezifizierer bewirkt, dass die abgeglichenen Zeichen gemäß der folgenden Tabelle als Teile von Datums- und Zeitdatentypen interpretiert werden.
Eine Zeichensequenz in der Formatzeichenkette, die mit einem % beginnt, aber nicht mit einem der folgenden Konvertierungsspezifizierer übereinstimmt, wird als normales Zeichen interpretiert.
Wenn from_stream nicht alles parsen kann, was durch die Formatzeichenkette spezifiziert ist, oder wenn nicht genügend Informationen zum Parsen einer vollständigen Ergebnisangabe vorhanden sind, oder wenn beim Parsen widersprüchliche Informationen aufgedeckt werden, wird is.setstate(std::ios_base::failbit) aufgerufen.
Die folgenden Konvertierungsspezifizierer sind verfügbar
| Konversion Spezifizierer |
Erklärung | |
|---|---|---|
%%
|
Passt zu einem literalen %-Zeichen. | |
%n
|
Passt zu einem Leerzeichen. | |
%t
|
Passt zu null oder einem Leerzeichen. | |
| Jahr | ||
%C %NC %EC
|
Parst das Jahrhundert als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl | |
%y %Ny %Ey %Oy
|
Parst die letzten zwei Dezimalziffern des Jahres. Wenn das Jahrhundert nicht anderweitig angegeben ist (z. B. mit %C), werden Werte im Bereich [69, 99] als Jahre 1969 bis 1999 und Werte im Bereich [00, 68] als Jahre 2000 bis 2068 angenommen. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Die modifizierten Befehle | |
%Y %NY %EY
|
Parst das Jahr als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 4. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl | |
| Monat | ||
%b%B%h
|
Parst den vollen oder abgekürzten, nicht Groß-/Kleinschreibung berücksichtigenden Monatsnamen der Locale. | |
%m%Nm%Om
|
Parst den Monat als Dezimalzahl (Januar ist 1). Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich.Der modifizierte Befehl | |
| Tag | ||
%d%Nd%Od%e%Ne%Oe
|
Parst den Tag des Monats als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Die modifizierten Befehle | |
| Wochentag | ||
%a%A
|
Parst den vollen oder abgekürzten, nicht Groß-/Kleinschreibung berücksichtigenden Wochentagsnamen der Locale. | |
%u%Nu
|
Parst den ISO-Wochentag als Dezimalzahl (1-7), wobei Montag 1 ist. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 1. Führende Nullen sind erlaubt, aber nicht erforderlich. | |
%w%Nw%Ow
|
Parst den Wochentag als Dezimalzahl (0-6), wobei Sonntag 0 ist. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 1. Führende Nullen sind erlaubt, aber nicht erforderlich.Der modifizierte Befehl | |
| ISO 8601 wochenbasierendes Jahr | ||
|
In ISO 8601 beginnen Wochen mit Montag, und die erste Woche des Jahres muss die folgenden Anforderungen erfüllen:
| ||
%g%Ng
|
Parst die letzten zwei Dezimalziffern des ISO 8601 wochenbasierten Jahres. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. | |
%G%NG
|
Parst das ISO 8601 wochenbasierte Jahr als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 4. Führende Nullen sind erlaubt, aber nicht erforderlich. | |
%V%NV
|
Parst die ISO 8601-Kalenderwoche des Jahres als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. | |
| Woche/Tag des Jahres | ||
%j%Nj
|
Parst den Tag des Jahres als Dezimalzahl (1. Januar ist 1). Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 3. Führende Nullen sind erlaubt, aber nicht erforderlich. | |
%U%NU%OU
|
Parst die Wochennummer des Jahres als Dezimalzahl. Der erste Sonntag des Jahres ist der erste Tag der Woche 01. Tage desselben Jahres vor diesem sind in Woche 00. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl | |
%W%NW%OW
|
Parst die Wochennummer des Jahres als Dezimalzahl. Der erste Montag des Jahres ist der erste Tag der Woche 01. Tage desselben Jahres vor diesem sind in Woche 00. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl | |
| Datum | ||
%D
|
Entspricht "%m/%d/%y". | |
%F%NF
|
Entspricht "%Y-%m-%d". Wenn die Breite angegeben ist, wird sie nur auf %Y angewendet. | |
%x%Ex
|
Parst die Datumsdarstellung der Locale. Der modifizierte Befehl | |
| Tageszeit | ||
%H%NH%OH
|
Parst die Stunde (24-Stunden-Format) als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl | |
%I%NI%OI
|
Parst die Stunde (12-Stunden-Format) als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl | |
%M%NM%OM
|
Parst die Minute als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl | |
%S%NS%OS
|
Parst die Sekunde als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl | |
%p
|
Parst die entsprechende AM/PM-Bezeichnung der Locale, die mit einer 12-Stunden-Uhr assoziiert ist. | |
%R
|
Entspricht "%H:%M". | |
%T
|
Entspricht "%H:%M:%S". | |
%r
|
Parst die 12-Stunden-Uhrzeit der Locale. | |
%X%EX
|
Parst die Zeitdarstellung der Locale. Der modifizierte Befehl | |
| Sonstiges | ||
%c%Ec
|
Parst die Datums- und Zeitdarstellung der Locale. Der modifizierte Befehl | |
%z%Ez%Oz
|
Parst den Offset von UTC im Format [+|-]hh[mm]. Zum Beispiel bezieht sich -0430 auf 4 Stunden und 30 Minuten hinter UTC, und 04 bezieht sich auf 4 Stunden vor UTC.Die modifizierten Befehle | |
%Z
|
Parst die Zeitzonenabkürzung oder den Zeitzonennamen, genommen als die längste Sequenz von Zeichen, die nur die Zeichen A bis Z, a bis z, 0 bis 9, -, +, _ und / enthält. | |
[bearbeiten] Rückgabewert
ist
[bearbeiten] Siehe auch
| (C++20) |
parst ein chrono Objekt aus einem Stream(Funktions-Template) |