std::getline

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de cadenas

Cadenas terminadas en nulo

Cadenas de bytes

Cadenas multibyte

De caracteres anchos

Clases

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

Funciones miembro basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator Acceso a elementos basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) basic_string::data basic_string::c_str basic_string::operator basic_string_view (C++17) Iteradores basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) Capacidad basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (C++11)

Operaciones basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back (C++11) basic_string::append basic_string::operator+= basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap Búsqueda basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of Constantes basic_string::npos

Funciones no miembro operator+ swap(std::basic_string) operator""s (C++14) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) E/S operator<<operator>> getline Comparación operator==operator!=operator<operator>operator<=operator>=operator<=> (hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(C++20) Conversión numérica (C++11) stoistolstoll stoulstoull stofstodstold to_string to_wstring Clases auxiliares hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string>hash<std::u8string> (C++11)(C++11)(C++11)(C++11)(C++20) hash<std::pmr::string>hash<std::pmr::wstring>hash<std::pmr::u32string>hash<std::pmr::u16string>hash<std::pmr::u8string> (C++20)(C++20)(C++20)(C++20)(C++20) Guías de deducción(C++17)

 

Definido en el archivo de encabezado <string>
template<class CharT, class Traits, class Allocator > std::basic_istream<CharT,Traits>& getline(std::basic_istream<CharT,Traits>& input,                                            std::basic_string<CharT,Traits,Allocator>& str,                                            CharT delim );	(1)
template<class CharT, class Traits, class Allocator > std::basic_istream<CharT,Traits>& getline(std::basic_istream<CharT,Traits>&& input,                                            std::basic_string<CharT,Traits,Allocator>& str,                                            CharT delim );	(1)	(desde C++11)
template<class CharT, class Traits, class Allocator > std::basic_istream<CharT,Traits>& getline(std::basic_istream<CharT,Traits>& input,                                            std::basic_string<CharT,Traits,Allocator>& str );	(2)
template<class CharT, class Traits, class Allocator > std::basic_istream<CharT,Traits>& getline(std::basic_istream<CharT,Traits>&& input,                                            std::basic_string<CharT,Traits,Allocator>& str );	(2)	(desde C++11)

getline lee los caracteres de una secuencia de entrada y los coloca en una cadena:

1) Se comporta como una función de entrada sin formato, UnformattedInputFunction, excepto que input.gcount() no se ve afectada. Después de construir y comprobar el objeto centinela, realiza lo siguiente:

1) Llama a str.erase();

2) Extrae caracteres de input y los añade a str hasta que ocurre una de las siguientes situaciones (comprobadas en el orden indicado):

a) existe la condición de fin de archivo en input, en cuyo caso getline establece eofbit.

b) el siguiente carácter de entrada disponible es delim, como si se hubiera probado mediante Traits::eq(c, delim), en cuyo caso el carácter delimitador se extrae de input, pero no se añade a str.

c) se han almacenado str.max_size() caracteres, en cuyo caso getline establece failbit y retorna.

3) Si no se extrajeron caracteres por alguna razon (ni siquiera el delimitador descartado), getline establece failbit y retorna.

2) Lo mismo que getline(input, str, input.widen('\n')), es decir, el delimitador por defecto es el carácter fin de línea.

Parámetros

input	-	El flujo del cual obtener los datos.
str	-	La cadena en la cual poner los datos.
delim	-	El carácter delimitador.

Valor de retorno

input

Notas

Al consumir una entrada delimitada por espacios en blanco (p. ej., int n;std::cin>> n;) cualquier espacio en blanco que siga, incluyendo el carácter de nueva línea, se dejará en el flujo de entrada. Entonces, al cambiar a entrada orientada a líneas, la primer línea que se recupere con getline será solamente ese espacio en blanco. En el dado caso que esto sea comportamiento no deseado, las posibles soluciones incluyen:

• hacer una llamada inicial explícita superflua a getline;
• eliminar espacios en blanco consecutivos con std::cin>>std::ws;
• ignorar todos los caracteres restantes en la línea de entrada con cin.ignore(std::numeric_limits<std::streamsize>::max(), '\n');

Ejemplo

El siguiente ejemplo demuestra cómo usar la función getline para leer la entrada del usuario y cómo procesar un archivo/fichero línea por línea.

Ejecuta este código

#include <string>#include <iostream>#include <sstream>   int main(){// saludar al usuariostd::string nombre;std::cout<<"Cual es tu nombre? "; std::getline(std::cin, nombre);std::cout<<"Hola "<< nombre <<", encantado(a) de conocerte.\n";   // leer un archivo/fichero línea por líneastd::istringstream input; input.str("1\n2\n3\n4\n5\n6\n7\n");int suma =0;for(std::string line; std::getline(input, line);){ suma +=std::stoi(line);}std::cout<<"\La suma es: "<< suma <<"\n";}

Posible salida:

Cual es tu nombre? Aquiles Pinto Flores Hola Aquiles Pinto Flores, encantado(a) de conocerte.   La suma es 28

Véase también

getline

Extrae caracteres hasta que se encuentra el carácter dado. (función miembro pública de std::basic_istream)