Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::getline: odczyt tekstu do ogranicznika

std::getline zastępuje zawartość std::string znakami ze strumienia do ogranicznika, który pobiera, lecz nie dołącza.

Wersja: C++23

Składnia

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) działa jak niesformatowana funkcja wejścia: po poprawnym sentry wykonuje text.erase(), a następnie dołącza znaki aż do EOF, następnego delim lub text.max_size(). Ogranicznik zostaje pobrany ze strumienia, ale nie trafia do napisu. Przeciążenie bez ogranicznika używa input.widen('\n') i nie zmienia późniejszego gcount().

Przykład czyta z red,green\n: pierwsze wywołanie zatrzymuje się na przecinku, drugie na końcu linii, dlatego wypisuje red|green. Zmienna docelowa jest zastępowana, a nie rozszerzana o poprzednią zawartość.

Jeśli nie pobrano żadnego znaku, ustawiany jest failbit; EOF ustawia eofbit, a osiągnięcie max_size() także powoduje failbit. Bity objęte maską exceptions() mogą wywołać std::ios_base::failure. Po wcześniejszym operatorze >> pozostawiony znak nowej linii może dać pusty rekord; usuń go przez ignore albo użyj odpowiednio std::ws, pamiętając, że std::ws usuwa wszystkie początkowe białe znaki.

Przykłady

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

Wynik

red|green

std::getline → red|green

Źródła