getline
Cadenas de extracto del flujo de entrada línea por línea.
template<class CharType, class Traits, class Allocator>
basic_istream<CharType, Traits>& getline(
basic_istream<CharType, Traits>& _Istr,
basic_string<CharType, Traits, Allocator>& _Str
);
template<class CharType, class Traits, class Allocator>
basic_istream< CharType, Traits >& getline(
basic_istream< CharType, Traits >& _Istr,
basic_string< CharType, Traits, Allocator >& _Str,
CharType _Delim
);
template<class Allocator, class Traits, class Allocator>
basic_istream< Allocator, Traits >& getline(
basic_istream< Allocator, Traits >&& _Istr,
basic_string< Allocator, Traits, Allocator >& _Str
);
template<class CharType, class Traits, class Allocator>
basic_istream<CharType, Traits>& getline(
basic_istream<CharType, Traits>&& _Istr,
basic_string<CharType, Traits, Allocator>& _Str,
const CharType _Delim
);
Parámetros
_Istr
El flujo de entrada de que una cadena debe ser extraída._Str
La cadena en la que se leen los caracteres del flujo de entrada._Delim
el delimitador de la línea.
Valor devuelto
la primera función devuelve getline( _Istr, _Str, _Istr.widen(“\n")).
La segunda función reemplaza la secuencia controlada por _Str con una secuencia de elementos de la secuencia _Istr.
Restantes las funciones son análogos los anteriores, pero con Son y valores r.
Comentarios
En orden de pruebas, la recuperación se detiene:
Al final del archivo.
Después de que la función extrae un elemento que comparar el igual a delim, en cuyo caso el elemento ni es posterior título ni anexado a la secuencia controlada.
Después de que la función extrae los elementos de str.max_size , en cuyo caso las llamadas de función setstate(ios_base::failbit).
Si la función no extrae ningún elemento, llama a setstate(failbit).En cualquier caso, devuelve _Istr.
Ejemplo
Vea string::getline para obtener un ejemplo de getlinemediante.
Requisitos
encabezado: <cadena>
espacio de nombres: std