Condividi tramite


basic_istream::getline

Ottiene una riga dal flusso di input.

basic_istream<Elem, Tr>& getline(
    char_type *_Str, 
    streamsize _Count
);
basic_istream<Elem, Tr>& getline(
    char_type *_Str, 
    streamsize _Count, 
    char_type _Delim
);

Parametri

  • _Count
    Il numero di caratteri da leggere da strbuf.

  • _Delim
    Il carattere che deve terminare lettura se viene rilevato prima di _Count.

  • _Str
    Una stringa in cui scrivere.

Valore restituito

Il flusso (*this).

Note

Il primo di questi restituisce senza formato getline(_Str, _Count, widen("\n") di funzioni di input).

La seconda funzione estrae fino a _Count - 1 elementi e li archivia in inizio di matrice di _Str. Memorizza sempre il carattere di terminazione di stringa dopo che tutti gli elementi estratti che archivia. Per test, interruzioni di estrazione:

  • Alla fine di un file.

  • Dopo che la funzione estrae un elemento in cui si confronta uguale a _Delimin questo caso, l'elemento non è ancora stato riavviato non viene aggiunto alla sequenza selezionata.

  • Dopo function estrae _Count - gli elementi 1.

Se la funzione non consente di disegnare elementi o _Count - 1 elementi, chiama setstate(failbit). Tuttavia, restituisce *this.

Esempio

// 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;
}
  

Requisiti

istream <diIntestazione: >

Spazio dei nomi: std

Vedere anche

Riferimenti

Classe basic_istream

Programmazione di iostream

Convenzioni di iostream