basic_istream::getline
Ruft eine Zeile im Eingabestream ab.
basic_istream<Elem, Tr>& getline(
char_type *_Str,
streamsize _Count
);
basic_istream<Elem, Tr>& getline(
char_type *_Str,
streamsize _Count,
char_type _Delim
);
Parameter
_Count
Die Anzahl der zu lesenden Zeichen von strbuf._Delim
Das Zeichen, das das Lesen beenden soll, wenn sie vor _Count erreicht wird._Str
In der eine Zeichenfolge zu schreiben.
Rückgabewert
Der Stream (*this).
Hinweise
Das erste dieser unformatierten Eingabefunktionsrückgaben getline(_Str, _Count, widen("\n")).
Die zweite Funktion extrahiert bis zu _Count-Elemente 1 und speichert sie im Arrayanfang am _Str.Sie speichert immer das Zeichenendezeichen, nachdem alle extrahierten Elemente, die auf speichert.In der Reihenfolge der Tests Extraktionshalt:
An Dateiende.
Nachdem die Funktion ein Element extrahiert, das gleich _Delim vergleicht, in diesem Fall das Element weder noch angefügt zur gesteuerten Sequenz gesetztes hinteres ist.
Nach der Funktion extrahiert _Count-Elemente 1.
Wenn die Funktion keine Elemente oder _Count - 1 Elemente extrahiert, ruft sie setstate an (failbit).In jedem Fall wird *this zurück.
Beispiel
// 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;
}
Anforderungen
Header: <istream>
Namespace: std