Freigeben über


getline

Extrahieren von Zeichenfolgen aus dem Eingabestream zeilenweise.

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

Parameter

  • _Istr
    Der Eingabestream, aus der eine Zeichenfolge extrahiert werden soll.

  • _Str
    Die Zeichenfolge, in der die Zeichen aus dem Eingabestream gelesen werden.

  • _Delim
    Das Zeilentrennzeichen.

Rückgabewert

Die erste Funktion gibt getlinezurück ( _Istr, _Str, _Istr.widen(„\n")).

Die zweite Funktion ersetzt die Sequenz, die durch _Str durch eine Sequenz von Elementen gesteuert wird, die aus dem Stream _Istrextrahiert wird.

Die übrigen Funktionen sind jedoch einen zuvor zu Entsprechungen mit Lvalues und Rvalue.

Hinweise

In der Reihenfolge der Tests lauscht Extraktion auf:

  • Klicken Sie am Dateiende.

  • Nachdem die Funktion ein Element extrahiert, der gleich delimvergleicht, in diesem Fall das Element noch nicht gesetztes hinteres der kontrollierten Sequenz angefügt ist.

  • Nachdem die Funktion str.Elementemax_size extrahiert. In diesem Fall wird die Funktion setstate(ios_base::failbit).

Wenn die Funktion keine Elemente extrahiert wird, ruft sie setstate(failbit).In jedem Fall gibt es _Istrzurück.

Beispiel

Weitere Informationen finden Sie unter string::getline als ein Beispiel für die Verwendung von getline.

Anforderungen

Header: <string>

Namespace: std

Siehe auch

Referenz

<string>

basic_string Class

string::getline

Weitere Ressourcen

<string> Member

basic_string Member