Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri