Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::getline: leggere testo fino a un delimitatore

std::getline sostituisce uno std::string con caratteri dello stream fino a un delimitatore estratto ma non aggiunto.

Versione: C++23

Sintassi

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) si comporta come input non formattato: dopo un sentry riuscito chiama text.erase() e aggiunge caratteri fino a EOF, al prossimo delim o a text.max_size(). Il delimitatore viene estratto dallo stream ma non memorizzato. L’overload senza delimitatore usa input.widen('\n') e non altera un successivo gcount().

L’esempio legge red,green\n: la prima chiamata si ferma alla virgola e la seconda alla fine riga, quindi stampa red|green. La destinazione viene sostituita, non estesa dal contenuto precedente.

Se non viene estratto alcun carattere si imposta failbit; EOF imposta eofbit e raggiungere max_size() imposta anche failbit. I bit abilitati in exceptions() possono lanciare std::ios_base::failure. Dopo operator>>, una newline residua può produrre una riga vuota; consumala con ignore o usa consapevolmente std::ws, che rimuove ogni spazio iniziale.

Esempi

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

Risultato

red|green

std::getline → red|green

Fonti