CKTIS / C++
std::getline: čítanie textu po oddeľovač
std::getline nahradí std::string znakmi zo streamu po oddeľovač, ktorý načíta, ale nepripojí.
Verzia: 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) sa správa ako neformátovaný vstup: po úspešnom sentry zavolá text.erase() a pripája znaky do EOF, ďalšieho delim alebo text.max_size(). Oddeľovač zo streamu načíta, ale neuloží. Preťaženie bez oddeľovača používa input.widen('\n') a neovplyvní neskoršie gcount().
Príklad číta red,green\n: prvé volanie skončí na čiarke a druhé na konci riadka, preto vypíše red|green. Cieľ sa nahradí, nerozširuje sa o starý obsah.
Ak sa nenačíta žiadny znak, nastaví sa failbit; EOF nastaví eofbit a dosiahnutie max_size() tiež failbit. Bity povolené v exceptions() môžu vyhodiť std::ios_base::failure. Po operator>> môže zvyšný koniec riadka dať prázdny záznam; spotrebujte ho cez ignore alebo zámerne std::ws, ktoré odstráni všetky úvodné biele znaky.
Prí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ýsledok
red|green
std::getline → red|green