CKTIS / C++
std::getline: Text bis zu einem Trennzeichen lesen
std::getline ersetzt einen std::string durch Streamzeichen bis zu einem gelesenen, aber nicht angehängten Trennzeichen.
Version: C++23
Syntax
template<class CharT, class Traits, class Allocator>
std::basic_istream<CharT, Traits>&
std::getline(std::basic_istream<CharT, Traits>& input,
std::basic_string<CharT, Traits, Allocator>& text,
CharT delimiter);
// Without delimiter, uses input.widen('\n').std::getline(input, text, delim) arbeitet wie eine unformatierte Eingabefunktion: Nach erfolgreichem Sentry ruft sie text.erase() auf und hängt Zeichen bis EOF, zum nächsten delim oder bis text.max_size() an. Das Trennzeichen wird aus dem Stream entfernt, aber nicht gespeichert. Die Überladung ohne Trennzeichen nutzt input.widen('\n') und verändert ein späteres gcount() nicht.
Das Beispiel liest red,green\n: Der erste Aufruf endet am Komma, der zweite am Zeilenende, sodass red|green ausgegeben wird. Das Ziel wird ersetzt und nicht um seinen alten Inhalt erweitert.
Wurde kein Zeichen extrahiert, wird failbit gesetzt; EOF setzt eofbit, und max_size() führt ebenfalls zu failbit. In exceptions() aktivierte Bits können std::ios_base::failure auslösen. Nach formatiertem operator>> kann ein verbliebenes Zeilenende einen leeren Datensatz liefern; verbrauche es mit ignore oder bewusst mit std::ws, das jedoch sämtlichen führenden Leerraum entfernt.
Beispiele
#include <iostream>
#include <sstream>
#include <string>
int main() {
std::istringstream input{"red,green\n"};
std::string first;
std::string second;
std::getline(input, first, ',');
std::getline(input, second);
std::cout << first << '|' << second << '\n';
}
Ergebnis
red|green
std::getline → red|green