WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen