CKTIS / C++
std::getline: branje besedila do ločila
std::getline zamenja std::string z znaki toka do ločila, ki ga prebere, vendar ne doda.
Različica: C++23
Sintaksa
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) deluje kot neoblikovan vhod: po uspešnem sentry pokliče text.erase() in dodaja znake do EOF, naslednjega delim ali text.max_size(). Ločilo odstrani iz toka, vendar ga ne shrani. Preobremenitev brez ločila uporabi input.widen('\n') in ne vpliva na poznejši gcount().
Primer bere red,green\n: prvi klic se ustavi pri vejici, drugi pri koncu vrstice, zato izpiše red|green. Cilj se zamenja in ne razširi iz prejšnje vsebine.
Če ni prebran noben znak, se nastavi failbit; EOF nastavi eofbit, dosežen max_size() pa tudi failbit. Biti v exceptions() lahko sprožijo std::ios_base::failure. Po operator>> lahko preostala nova vrstica da prazen zapis; porabi jo z ignore ali premišljeno s std::ws, ki odstrani ves začetni prazen prostor.
Primeri
#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';
}
Rezultat
red|green
std::getline → red|green