basic_istream::getline
Ruft eine Zeile des Eingabestreams 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 aus strbuf._Delim
Das Zeichen, das zum Lesen beendet werden soll, wenn es vor _Count erreicht wird._Str
In der eine Zeichenfolge zu schreiben.
Rückgabewert
Der Stream (*this).
Hinweise
Das erste dieser häufig Eingabefunktionsrückgaben getline(_Str, _Count, widen("\n")).
Die zweite Funktion extrahiert bis _Count-Elemente 1 und speichert sie im Arrayanfang am _Str. Sie speichert immer das Zeichenendezeichen, nachdem alle extrahierten Elemente, die es speichert. In der Reihenfolge der Tests Extraktionshalt:
An Dateiende.
Nachdem die Funktion ein Element extrahiert, das gleich _Delim vergleicht, in diesem Fall das Element angefügt weder noch zur gesteuerten Sequenz gesetztes wieder ist.
Nach der Funktion extrahiert _Count-Elemente 1.
Wenn die Funktion keine Elemente oder _Count - 1 Elemente extrahiert, ruft sie auf setstate(failbit). Auf jeden Fall gibt diese *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