std::chrono:: from_stream (std::chrono::month)

Definiert im Header <chrono>
template < class CharT, class Traits, class Alloc = std:: allocator < CharT > > std:: basic_istream < CharT, Traits > & from_stream ( std:: basic_istream < CharT, Traits > & is, const CharT * fmt, std:: chrono :: month & m, std:: basic_string < CharT, Traits, Alloc > * abbrev = nullptr, std:: chrono :: minutes * offset = nullptr ) ;		(seit C++20)

Versucht, den Eingabestream is gemäß der Formatzeichenkette fmt in den std::chrono::month m zu parsen.

Verhält sich wie eine UnformattedInputFunction , mit der Ausnahme, dass es einen nicht spezifizierten Effekt auf is. gcount ( ) hat. Nach dem Konstruieren und Prüfen des Sentry-Objekts wird versucht, den Eingabestrom is gemäß dem Formatstring fmt in m zu parsen. Wenn das Parsen fehlschlägt, einen gültigen month zu decodieren, wird is. setstate ( std:: ios_base :: failbit ) aufgerufen und m bleibt unverändert.

Wenn der Formatbezeichner %Z verwendet und erfolgreich geparst wird, wird der geparste Wert * abbrev zugewiesen, falls abbrev nicht null ist. Wenn der Formatbezeichner %z oder eine modifizierte Variante verwendet und erfolgreich geparst wird, wird der geparste Wert * offset zugewiesen, falls offset nicht null ist.

Inhaltsverzeichnis 1 Parameter 2 Formatzeichenkette 3 Rückgabewert 4 Siehe auch

Parameter

is	-	ein Eingabestream
fmt	-	eine Formatzeichenfolge (siehe unten)
m	-	Objekt zur Aufnahme des Parse-Ergebnisses
abbrev	-	falls nicht null, Zeiger auf ein Objekt, das die Zeitzonenabkürzung oder den Namen entsprechend dem %Z Spezifizierer enthält
offset	-	falls nicht null, Zeiger auf ein Objekt, das den UTC-Offset entsprechend dem %z Spezifizierer enthält

Format-String

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 folgenden 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 Formatzeichenkette 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:

Konvertierungs- spezifizierer	Erklärung
%%	Entspricht einem wörtlichen % Zeichen.
%n	Entspricht einem Leerzeichen.
%t	Entspricht null oder einem Leerzeichen.
Jahr
%C % N C %EC	Parst das Jahrhundert als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite beträgt 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl %EC interpretiert die alternative Darstellung des Jahrhunderts gemäß der Locale-Einstellung.
%y % N y %Ey %Oy	Parst die letzten zwei Dezimalstellen des Jahres. Wenn das Jahrhundert nicht anderweitig angegeben ist (z.B. mit %C), werden Werte im Bereich [69, 99] als die Jahre 1969 bis 1999 interpretiert, und Werte im Bereich [00, 68] als die Jahre 2000 bis 2068. 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 %Ey und %Oy interpretieren die alternative Darstellung der Locale.
%Y % N Y %EY	Parst das Jahr als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite beträgt 4. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl %EY interpretiert die alternative Darstellung des Gebietsschemas.
Monat
%b %B %h	Analysiert den vollständigen oder abgekürzten, groß-/kleinschreibungsunabhängigen Monatsnamen der Lokalisierung.
%m % N m %Om	Analysiert 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 %Om interpretiert die alternative Darstellung des Gebietsschemas.
Tag
%d % N d %Od %e % N e %Oe	Analysiert 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 %Od und %Oe interpretieren die alternative Darstellung der Locale.
Wochentag
%a %A	Analysiert den vollständigen oder abgekürzten, groß-/kleinschreibungsunabhängigen Wochentagsnamen der Locale.
%u % N u	Interpretiert den ISO-Wochentag als Dezimalzahl (1-7), wobei Montag 1 entspricht. 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 % N w %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 %Ow interpretiert die alternative Darstellung des Gebietsschemas.
ISO 8601 wochenbasiertes Jahr
In ISO 8601 beginnen Wochen mit Montag und die erste Woche des Jahres muss die folgenden Anforderungen erfüllen: Enthält den 4. Januar Enthält den ersten Donnerstag des Jahres
%g % N g	Analysiert die letzten zwei Dezimalstellen des ISO 8601 wochenbasierten Jahres. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite beträgt 2. Führende Nullen sind erlaubt, aber nicht erforderlich.
%G % N G	Analysiert die ISO 8601 wochenbasierte Jahreszahl als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite beträgt 4. Führende Nullen sind erlaubt, aber nicht erforderlich.
%V % N V	Analysiert die ISO-8601-Kalenderwoche als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite beträgt 2. Führende Nullen sind erlaubt, aber nicht erforderlich.
Woche/Tag des Jahres
%j % N j	Analysiert 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 % N U %OU	Erfasst die Wochennummer des Jahres als Dezimalzahl. Der erste Sonntag des Jahres ist der erste Tag von Woche 01. Tage desselben Jahres davor 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 %OU interpretiert die alternative Darstellung des Gebietsschemas.
%W % N W %OW	Analysiert die Wochennummer des Jahres als Dezimalzahl. Der erste Montag des Jahres ist der erste Tag der Woche 01. Tage desselben Jahres davor 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 %OW interpretiert die alternative Darstellung des Gebietsschemas.
Datum
%D	Entspricht "%m/%d/%y" .
%F % N F	Entspricht "%Y-%m-%d" . Wenn die Breite angegeben ist, wird sie nur auf %Y angewendet.
%x %Ex	Analysiert die lokale Datumsdarstellung. Der modifizierte Befehl %Ex interpretiert die alternative Datumsdarstellung des Gebietsschemas.
Tageszeit
%H % N H %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 %OH interpretiert die alternative Darstellung des Gebietsschemas.
%I % N I %OI	Analysiert 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 %OI interpretiert die alternative Darstellung des Gebietsschemas.
%M % N M %OM	Interpretiert die Minute als Dezimalzahl. Die Breite N gibt die maximale Anzahl zu lesender Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl %OM interpretiert die alternative Darstellung der Locale.
%S % N S %OS	Parst die Sekunde als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite beträgt 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl %OS interpretiert die alternative Darstellung der Locale.
%p	Analysiert die lokalen Entsprechungen der AM/PM-Bezeichnungen, die mit einer 12-Stunden-Uhr assoziiert sind.
%R	Entspricht "%H:%M" .
%T	Entspricht "%H:%M:%S" .
%r	Analysiert die 12-Stunden-Uhrzeit der jeweiligen Locale.
%X %EX	Analysiert die lokale Zeitdarstellung. Der modifizierte Befehl %EX interpretiert die alternative Zeitdarstellung des Gebietsschemas.
Sonstiges
%c %Ec	Analysiert die lokale Datums- und Zeitdarstellung. Der modifizierte Befehl %Ec interpretiert die alternative lokale Datums- und Zeitdarstellung.
%z %Ez %Oz	Analysiert den UTC-Offset im Format [+|-]hh[mm] . Zum Beispiel bezieht sich -0430 auf 4 Stunden 30 Minuten hinter UTC und 04 bezieht sich auf 4 Stunden vor UTC. Die modifizierten Befehle %Ez und %Oz analysieren das Format [+|-]h[h][:mm] (d.h. sie erfordern einen : zwischen Stunden und Minuten und machen die führende Null für die Stunde optional).
%Z	Analysiert die Zeitzonenabkürzung oder den Namen, aufgenommen als die längste Zeichenfolge, die nur die Zeichen A bis Z , a bis z , 0 bis 9 , - , + , _ und / enthält.

Rückgabewert

is

Siehe auch

parse (C++20)

parst ein chrono -Objekt aus einem Stream (Funktions-Template)