scanf Breitenangabe

Diese Informationen beziehen sich auf die Interpretation von Formatzeichenfolgen in der scanf-Funktionsreihe, einschließlich der sicheren Versionen wie scanf_s.Diese Funktionen nehmen normalerweise an, dass der Eingabestream in eine Abfolge der Token aufgeteilt wird.Token werden durch Leerzeichen (Leerzeichen, Zeilenvorschub) oder Tabstopps oder im Falle der numerischen Typen, getrennt durch die natürliche Ende eines numerischen Datentyps, wie vom ersten Zeichen angegeben, die nicht in numerischen Text konvertiert werden kann.Die Breitenangabe verwendet werden, um die Analyse der Eingabe dass vor dem natürlichen Ende eines Tokens beenden.

Diese Breitenangabe besteht aus Zeichen zwischen % im Feld Typ und dem Parameterbezeichner, die möglicherweise eine positive ganze Zahl, die das Feld Breite und ein oder mehrere Zeichen angeben die Größe des Felds aufgerufen wird, deren betrachtet werden kann, auch als Modifizierer des Typs des Felds, wie Angabe, ob der ganzzahlige Typ short oder longist.Solche Zeichen als Präfix den Größen.

Das Breiten-Feld

Das FeldBreite ist eine positive ganze Dezimalzahl, die die maximale Anzahl der Steuerelemente für dieses Feld zu lesenden Zeichen.Nicht mehr als breite Zeichen sind am entsprechenden argumentkonvertiert und gespeichert.Weniger als breite Zeichen gelesen werden können, wenn ein Leerzeichen (Leerzeichen, Zeilenvorschub) oder Registerkarte eintritt oder ein Zeichen, die nicht entsprechend dem angegebenen Format konvertiert werden können, bevor Breite erreicht ist.

Diese Breitenangabe getrennt ist und der Puffergrößen - Argument unterschiedlich, das von der sicheren Versionen dieser Funktionen erforderlich ist (d. h. scanf_s, wscanf_susw.).Im folgenden Beispiel ist die Breitenangabe 20 und gibt an, dass bis zu 20 Zeichen aus dem Eingabestream gelesen werden sollen.Die Pufferlänge ist 21, die Platz für die möglichen 20 Zeichen plus NULL-Abschlusszeichen die Folgendes enthält:

char str[21];
scanf_s("%20s", str, 21);

Wenn das Feld Breite nicht verwendet wird, sind scanf_s Lese- das gesamte Token in der Zeichenfolge.Wenn die Größe, die angegeben wurde, nicht groß genug ist, um das gesamte Token enthält, wird nichts in der Zielzeichenfolge geschrieben.Wenn das Feld Breite angegeben wird, dann werden die ersten breite Zeichen im Token in der Zielzeichenfolge zusammen mit dem NULL-Abschlusszeichen geschrieben.

Das Größen-Präfix

Das optionale Präfix, hL, ll, I64und L geben die Größe argument an (kurz, Einzelbytezeichen lang oder Breitzeichen oder je nach Typzeichen, das sie ändern).Diese Formatelemente Zeichen werden mit Typzeichen in scanf oder wscanf-Funktionen verwendet, um Interpretation von Argumenten wie in der folgenden Tabelle gezeigt angeben.Das Präfix des Typs I64 ist eine Microsoft-Erweiterung und ist nicht kompatibel. ANSIDas Typzeichen und ihre Bedeutungen werden in „Typzeichen für scanf funktioniert“ Tabelle in scanf Typ-Feld-Zeichenbeschrieben.

Hinweis
h, die Lund L Präfixe sind Microsoft-Erweiterungen, wenn sie mit Daten vom Typ charverwendet werden.

Größen-Präfixe für wscanf und scanf FORMAT-TYPE-Spezifizierer

Die folgenden Beispiele verwenden h und L mit scanf_s-Funktionen und wscanf_s-Funktionen:

scanf_s( "%ls", &x, 2 );     // Read a wide-character string
wscanf_s( "%hC",&x, 2 );    // Read a single-byte character

Wenn Sie eine unsichere Funktion in der scanf Familie verwenden, lassen Sie den Größenparameter die Pufferlänge des vorherigen Arguments angibt.

Lesen Undelimited-Zeichenfolgen

Um die Zeichenfolgen zu lesen, die durch Leerzeichen getrennt sind, können nicht aus einem Satz von Zeichen in eckigen Klammern ([]) für das Typzeichen s (Zeichenfolge) ersetzt werden.Der Satz von Zeichen in eckigen Klammern wird als eine Zeichenfolge des Steuerelements.Das entsprechende Eingabefeld ist bis zum ersten Zeichen gelesen, das nicht in der Zeichenfolge des Steuerelements angezeigt wird.Wenn das erste Zeichen in der Gruppe ein Zirkumflexzeichen (^) ist, wird der Effekt umgekehrt: Das Eingabefeld ist bis zum ersten Zeichen gelesen, das im Rest des Zeichensatzes angezeigt wird.

Beachten Sie, dass % [a-z] und z-a [%] als Äquivalent zu **% [abcde… Z]**interpretiert werden.Dies ist eine allgemeine scanf-Funktionserweiterung, aber erwähnt, dass der ANSI-Standard sie nicht benötigt.

Lesen von Zeichenfolgen Unterminated

Um eine Zeichenfolge ohne ein NULL- („\ 0 ") speichern zu speichern, verwenden Sie die Spezifikation %nc wobei n eine ganze Dezimalzahl ist.In diesem Fall ist das C Zeichen an, dass das Argument ein Zeiger auf ein Zeichenarray ist.Die folgenden n-Zeichen werden aus dem Eingabestream an der angegebenen Position gelesen, und kein NULL-Zeichen („\ 0 ") angefügt wird.Wenn n nicht angegeben wird, lautet sein Standardwert 1.

Wenn scanf angehalten wird, ein Feld zu lesen

Die scanf-Funktion wird jedes Eingabefeld Zeichen für Zeichen.Er hört auf, um ein bestimmtes Eingabefeld zu lesen, bevor ein Leerzeichen aus mehreren Gründen erreicht:

• Die angegebene Breite ist erreicht.

• Das nächste Zeichen kann nicht konvertiert werden, wie angegeben.

• Das nächste Zeichen steht in Konflikt mit einem Zeichen in der Zeichenfolge des Steuerelements, die sie übereinstimmen soll.

• Das nächste Zeichen kann in einem angegebenen Zeichensatz werden nicht angezeigt.

Aus dem Grund immer auch wenn die scanf-Funktion beendet wird, ein Eingabefeld zu lesen, wird das folgende Eingabefeld ungelesenen berücksichtigt beim ersten Zeichen beginnt.Das widersprüchliche Zeichen, sofern vorhanden, wird als ungelesen ist und das erste Zeichen des nächsten Eingabefelds oder das erste Zeichen in den nachfolgenden Lesevorgängen auf dem Eingabestream.

Siehe auch

Referenz

scanf, _scanf_l, wscanf, _wscanf_l

scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l

Formatangaben-Felder: scanf und wscanf Funktionen

scanf Typ-Feld-Zeichen