Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::getline: čtení textu po oddělovač

std::getline nahradí std::string znaky ze streamu po oddělovač, který přečte, ale nepřipojí.

Verze: C++23

Syntaxe

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) se chová jako neformátovaný vstup: po úspěšném sentry zavolá text.erase() a připojuje znaky do EOF, dalšího delim nebo text.max_size(). Oddělovač ze streamu přečte, ale neuloží. Přetížení bez oddělovače používá input.widen('\n') a neovlivní pozdější gcount().

Příklad čte red,green\n: první volání skončí na čárce a druhé na konci řádku, proto vypíše red|green. Cíl se nahradí, nerozšiřuje se o starý obsah.

Pokud není přečten žádný znak, nastaví se failbit; EOF nastaví eofbit a dosažení max_size() rovněž failbit. Bity povolené v exceptions() mohou vyhodit std::ios_base::failure. Po operator>> může zbylý konec řádku dát prázdný záznam; spotřebujte jej pomocí ignore nebo záměrně std::ws, které odstraní všechny úvodní bílé znaky.

Příklady

#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';
}

Výsledek

red|green

std::getline → red|green

Zdroje