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 _Count.

  • _Str
    Una stringa in cui scrivere.

Valore restituito

Il flusso***this**().

Note

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

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

  • Alla fine di un file.

  • Dopo che la funzione viene disegnato un elemento che confronta uguale a _Delimin questo caso, l'elemento non è né riavviare né viene aggiunto alla sequenza selezionata.

  • Dopo la funzione estrae _Count - gli elementi 1.

Se la funzione non viene estratto 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

intestazione: <istream>

Spazio dei nomi: deviazione standard

Vedere anche

Riferimenti

basic_istream Class

programmazione di iostream

convenzioni di iostream