Compartir a través de


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

encabezado: <istream>

espacio de nombres: std

Vea también

Referencia

basic_istream Class

programación iostream

convenciones de iostreams