basic_istream::getline
Obtiene una línea del flujo de entrada.
basic_istream<Elem, Tr>& getline(
char_type *_Str,
streamsize _Count
);
basic_istream<Elem, Tr>& getline(
char_type *_Str,
streamsize _Count,
char_type _Delim
);
Parámetros
_Count
El número de caracteres para leer de strbuf._Delim
El carácter que debe finalizar la lectura si se encuentra antes de _Count._Str
Una cadena en la que se va a escribir.
Valor devuelto
La secuencia (*this).
Comentarios
El primer de estas funciones de entrada sin formato devuelve getline(_Str, _Count, widen(“\n")).
La segunda función extrae hasta _Count (elementos 1 y los almacena en el principio de la matriz en el _Str. Almacena siempre el carácter de terminación de cadena después de que los elementos extraídos que almacena. 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 la función extrae _Count - elementos 1.
Si la función no extrae ningún elemento o _Count - 1 elementos, llama a setstate(failbit). En cualquier caso, devuelve *this.
Ejemplo
// basic_istream_getline.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;
int main( )
{
char c[10];
cin.getline( &c[0], 5, '2' );
cout << c << endl;
}
Requisitos
istream <deEncabezado: >
Espacio de nombres: std