Condividi tramite


getline

Stringhe estrarre dal flusso di input riga per riga.

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
   );

Parametri

  • _Istr
    Il flusso di input che una stringa deve essere estratta.

  • _Str
    La stringa in cui vengono letti i caratteri dal flusso di input.

  • _Delim
    Il delimitatore della riga.

Valore restituito

la prima funzione restituisce getline( _Istr, _Str, _Istr.widen("\n").

La seconda funzione sostituisce la sequenza controllata da _Str con una sequenza di elementi estratti dal flusso _Istr.

Le funzioni rimanenti sono precedentemente analoghi a un, ma con Lvalue e di valori rvalue.

Note

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 è rimesso non viene aggiunto alla sequenza selezionata.

  • Dopo che la funzione estrae gli elementi di str.max_size in questo caso, le chiamate di funzione setstate(ios_base::failbit).

Se la funzione non consente di tracciare elementi, chiama setstate(failbit).Tuttavia, restituisce _Istr.

Esempio

Vedere string::getline per un esempio di utilizzo di getline.

Requisiti

intestazione: <stringa>

Spazio dei nomi: deviazione standard

Vedere anche

Riferimenti

<string>

basic_string Class

string::getline

Altre risorse

<stringa> membri

membri basic_string