std::ws

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Ein-/Ausgabe-Bibliothek

I/O-Manipulatoren

Print-Funktionen (C++23)

C-Style I/O

Puffer

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

Streams

Abstraktionen

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

Datei-I/O

basic_ifstream

basic_ofstream

basic_fstream

String-I/O

basic_istringstream

basic_ostringstream

basic_stringstream

Array-I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

Synchronisierte Ausgabe

basic_osyncstream (C++20)

Typen

streamoff

streamsize

fpos

Fehlerkategorie-Schnittstelle

iostream_category (C++11)

io_errc (C++11)

 

Input/output-Manipulatoren

Formatierung von Gleitkommazahlen
showpointnoshowpoint setprecision	fixedscientifichexfloatdefaultfloat (C++11)(C++11)
Ganzzahlformatierung
setbase showbasenoshowbase	dechexoct
Boolean-Formatierung
boolalphanoboolalpha
Feldbreiten- und Füllzeichensteuerung
setfill setw	internalleftright
Andere Formatierungen
showposnoshowpos	uppercasenouppercase
Leerzeichenverarbeitung
ws ends	skipwsnoskipws
Ausgabe-Flushen
flush endl flush_emit (C++20)	unitbufnounitbuf emit_on_flushnoemit_on_flush (C++20)(C++20)
Statusflags-Manipulation
resetiosflags	setiosflags
Zeit- und Geld-I/O
get_money (C++11) get_time (C++11)	put_money (C++11) put_time (C++11)
Gequoteter Manipulator
quoted (C++14)

 

Definiert in Header <istream>
template< class CharT, class Traits > std::basic_istream<CharT, Traits>& ws( std::basic_istream<CharT, Traits>& is );

Verwirft führende Leerzeichen aus einem Eingabestrom.

Verhält sich wie eine UnformattedInputFunction, außer dass is.gcount() nicht modifiziert wird. Nach dem Erstellen und Überprüfen des Sentry-Objekts werden Zeichen aus dem Strom extrahiert und verworfen, bis eine der folgenden Bedingungen eintritt:

• Das Dateiende wird in der Eingabesequenz erreicht (in diesem Fall ruft die Funktion setstate(eofbit) auf, setzt aber nicht failbit; dies gilt nicht, wenn das eofbit bereits auf is vor dem Aufruf von ws gesetzt ist, in welchem Fall das Erstellen des Sentry-Objekts failbit setzen würde).

• Das nächste verfügbare Zeichen c in der Eingabesequenz ist kein Leerzeichen, wie durch std::isspace(c, is.getloc()) bestimmt wird. Das Nicht-Leerzeichen wird nicht extrahiert.

Dies ist ein reiner Eingabe-I/O-Manipulator, er kann mit einem Ausdruck wie in >> std::ws für jedes in vom Typ std::basic_istream aufgerufen werden.

Parameter

ist

-

Referenz auf den Eingabestrom

Rückgabewert

is (Referenz auf den Strom nach der Extraktion aufeinanderfolgender Leerzeichen).

Hinweise

Wenn eofbit vor dem Aufruf auf dem Strom gesetzt ist, wird das Erstellen des Sentry-Objekts failbit setzen.

Beispiel

Führen Sie diesen Code aus

#include <iomanip>
#include <iostream>
#include <istream>
#include <sstream>
#include <string>
 
int main()
{
    for (const char* str : {"     #1 test", "\t #2 test", "#3 test"})
    {
        std::string line;
        std::getline(std::istringstream{str}, line);
        std::cout << "getline returns:\t" << std::quoted(line) << '\n';
 
        std::istringstream iss{str};
        std::getline(iss >> std::ws, line);
        std::cout << "ws + getline returns:\t" << std::quoted(line) << '\n';
    }
}

Ausgabe

getline returns:	"     #1 test"
ws + getline returns:	"#1 test"
getline returns:	"	 #2 test"
ws + getline returns:	"#2 test"
getline returns:	"#3 test"
ws + getline returns:	"#3 test"

Fehlerberichte

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

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 415	C++98	Der Aufruf von std::ws konstruiert möglicherweise nicht das Sentry-Objekt (inkonsistent mit anderen Eingabefunktionen)	erfordert die Konstruktion des Sentry-Objekts

Siehe auch

ignorieren

extrahiert und verwirft Zeichen, bis das gegebene Zeichen gefunden wird (public member function of std::basic_istream<CharT,Traits>)