std::getline

 

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

 

Bibliothek für Zeichenketten

Klassen

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

Memberfunktionen basic_string::basic_string basic_string::~basic_string basic_string::operator= basic_string::assign basic_string::assign_range (C++23)   basic_string::get_allocator Elementzugriff basic_string::at basic_string::operator[] basic_string::front (DR*) basic_string::back (DR*) basic_string::data basic_string::c_str basic_string::operator  basic_string_view (C++17) Iteratoren basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) Suche basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of

Modifizierer basic_string::clear basic_string::insert basic_string::insert_range (C++23) basic_string::erase basic_string::push_back basic_string::pop_back (DR*) basic_string::append basic_string::append_range (C++23) basic_string::operator+= basic_string::replace basic_string::replace_with_range (C++23) basic_string::copy basic_string::resize basic_string::resize_and_overwrite (C++23)  basic_string::swap Kapazität basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (DR*) Operationen basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::contains (C++23) basic_string::substr

Konstanten basic_string::npos Nicht-Member-Funktionen operator+ swap(std::basic_string) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) I/O operator<<operator>> getline Vergleich operator==operator!=operator<operator>operator<=operator>=operator<=> (bis C++20)(bis C++20)(bis C++20)(bis C++20)(bis C++20)(C++20) Numerische Konvertierungen stoistolstoll (C++11)(C++11)(C++11) stoulstoull (C++11)(C++11)  stofstodstold (C++11)(C++11)(C++11) to_string (C++11) to_wstring (C++11) Literale operator""s (C++14) Hilfsklassen hash<std::basic_string> (C++11) Deduction guides (C++17)

 

Definiert in Header <string>
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT, Traits>&     getline( std::basic_istream<CharT, Traits>& input,              std::basic_string<CharT, Traits, Allocator>& str, CharT delim );	(1)
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT, Traits>&     getline( std::basic_istream<CharT, Traits>&& input,              std::basic_string<CharT, Traits, Allocator>& str, CharT delim );	(2)	(seit C++11)
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT, Traits>&     getline( std::basic_istream<CharT, Traits>& input,              std::basic_string<CharT, Traits, Allocator>& str );	(3)
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT, Traits>&     getline( std::basic_istream<CharT, Traits>&& input,              std::basic_string<CharT, Traits, Allocator>& str );	(4)	(seit C++11)

getline liest Zeichen aus einem Eingabestrom und legt sie in einem String ab

1,2) Verhält sich wie eine UnformattedInputFunction, mit der Ausnahme, dass input.gcount() nicht beeinflusst wird. Nach dem Erstellen und Überprüfen des Sentry-Objekts wird Folgendes ausgeführt:

1) Ruft str.erase() auf.

2) Extrahiert Zeichen aus input und hängt sie an str an, bis eine der folgenden Bedingungen eintritt (in der aufgeführten Reihenfolge geprüft):

a) End-of-File-Bedingung für input. In diesem Fall setzt getline das eofbit.

b) Das nächste verfügbare Eingabezeichen ist delim, wie durch Traits::eq(c, delim) getestet. In diesem Fall wird das Trennzeichen aus input extrahiert, aber nicht an str angehängt.

c) str.max_size() Zeichen wurden gespeichert. In diesem Fall setzt getline das failbit und kehrt zurück.

3) Wenn aus irgendeinem Grund keine Zeichen extrahiert wurden (nicht einmal das verworfene Trennzeichen), setzt getline das failbit und kehrt zurück.

3,4) Gleich wie getline(input, str, input.widen('\n')), d.h. das Standard-Trennzeichen ist das Zeilenumbruchzeichen.

Parameter

input	-	der Stream, aus dem Daten gelesen werden sollen
str	-	der String, in den die Daten geschrieben werden sollen
delim	-	das Trennzeichen

Rückgabewert

input

Hinweise

Beim Lesen von durch Leerzeichen getrennten Eingaben (z. B. int n; std::cin >> n;) bleiben alle folgenden Leerzeichen, einschließlich eines Zeilenumbruchs, im Eingabestrom erhalten. Wenn dann zu zeilenorientierter Eingabe gewechselt wird, ist die erste mit getline gelesene Zeile nur diese Leerzeichen. In dem wahrscheinlichen Fall, dass dies unerwünscht ist, sind mögliche Lösungen:

• Ein expliziter zusätzlicher Aufruf von getline.
• Entfernen aufeinanderfolgender Leerzeichen mit std::cin >> std::ws.
• Ignorieren aller verbleibenden Zeichen in der Eingabezeile mit cin.ignore(std::numeric_limits::max(), '\n').

Beispiel

Das folgende Beispiel zeigt, wie die Funktion getline verwendet wird, um Benutzereingaben zu lesen und einen Stream zeilenweise oder in Teilen einer Zeile mithilfe des Parameters delim zu verarbeiten.

Führen Sie diesen Code aus

#include <iostream>
#include <sstream>
#include <string>
 
int main()
{
    // greet the user
    std::string name;
    std::cout << "What is your name? ";
    std::getline(std::cin, name);
    std::cout << "Hello " << name << ", nice to meet you.\n";
 
    // read file line by line
    std::istringstream input;
    input.str("1\n2\n3\n4\n5\n6\n7\n");
    int sum = 0;
    for (std::string line; std::getline(input, line);)
        sum += std::stoi(line);
    std::cout << "\nThe sum is " << sum << ".\n\n";
 
    // use separator to read parts of the line
    std::istringstream input2;
    input2.str("a;b;c;d");
    for (std::string line; std::getline(input2, line, ';');)
        std::cout << line << '\n';
}

Mögliche Ausgabe

What is your name? John Q. Public
Hello John Q. Public, nice to meet you.
 
The sum is 28.
 
a
b
c
d

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 91	C++98	getline verhielt sich nicht wie eine unformatierte Eingabefunktion	verhält sich wie eine unformatierte Eingabefunktion

Siehe auch

getline

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