Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::getline: leer texto hasta un delimitador

std::getline sustituye un std::string por caracteres del flujo hasta un delimitador que extrae pero no añade.

Versión: C++23

Sintaxis

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) se comporta como entrada no formateada: tras un sentry correcto llama a text.erase() y añade caracteres hasta EOF, el siguiente delim o text.max_size(). El delimitador se extrae del flujo pero no se guarda. La sobrecarga sin delimitador usa input.widen('\n') y no afecta a un gcount() posterior.

El ejemplo lee red,green\n: la primera llamada se detiene en la coma y la segunda en el fin de línea, así que imprime red|green. El destino se sustituye, no se amplía desde su contenido previo.

Si no se extrae ningún carácter se establece failbit; EOF establece eofbit, y alcanzar max_size() también establece failbit. Los bits habilitados en exceptions() pueden lanzar std::ios_base::failure. Después de operator>>, un salto de línea pendiente puede producir un registro vacío; consúmelo con ignore o usa deliberadamente std::ws, que elimina todo espacio inicial.

Ejemplos

#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

Fuentes