Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::getline: čitanje teksta do graničnika

std::getline zamjenjuje std::string znakovima toka do graničnika koji čita, ali ne dodaje.

Verzija: 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) ponaša se kao neformatirani ulaz: nakon uspješnog sentryja poziva text.erase() i dodaje znakove do EOF-a, sljedećeg delim ili text.max_size(). Graničnik uklanja iz toka, ali ga ne sprema. Preopterećenje bez graničnika koristi input.widen('\n') i ne utječe na kasniji gcount().

Primjer čita red,green\n: prvi poziv staje na zarezu, a drugi na kraju retka, pa ispisuje red|green. Odredište se zamjenjuje, a ne proširuje starim sadržajem.

Ako nije pročitan nijedan znak, postavlja se failbit; EOF postavlja eofbit, a dosezanje max_size() također failbit. Bitovi u exceptions() mogu baciti std::ios_base::failure. Nakon operator>> preostali novi red može dati prazan zapis; ukloni ga s ignore ili namjerno koristi std::ws, koji uklanja sve početne bjeline.

Primjeri

#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

Izvori