Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::getline: ler texto até um delimitador

std::getline substitui um std::string pelos caracteres do fluxo até um delimitador extraído mas não acrescentado.

Versão: C++23

Sintaxe

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) comporta-se como entrada não formatada: após sentry bem-sucedido chama text.erase() e acrescenta caracteres até EOF, ao próximo delim ou a text.max_size(). O delimitador é extraído do fluxo mas não guardado. O overload sem delimitador usa input.widen('\n') e não afeta um gcount() posterior.

O exemplo lê red,green\n: a primeira chamada para na vírgula e a segunda no fim de linha, logo imprime red|green. O destino é substituído, não prolongado a partir do conteúdo anterior.

Se nenhum carácter for extraído, define-se failbit; EOF define eofbit, e atingir max_size() também define failbit. Bits ativos em exceptions() podem lançar std::ios_base::failure. Depois de operator>>, uma mudança de linha restante pode produzir um registo vazio; consome-a com ignore ou usa deliberadamente std::ws, que remove todo o espaço inicial.

Exemplos

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

Resultado

red|green

std::getline → red|green

Fontes