basic_istream::read

Liest eine festgelegte Anzahl von Zeichen aus dem Stream und speichert sie in ein Array.

Diese Methode ist möglicherweise unsicher, da sie für den Aufrufer basiert, um zu überprüfen, ob die übergebenen Werte korrekt sind.

basic_istream<Elem, Tr>& read(
    char_type *_Str, 
    streamsize _Count
);

Parameter

  • _Str
    In dem das Array, um die Zeichen zu lesen.

  • _Count
    Die Anzahl der zu lesenden Zeichen.

Rückgabewert

Der Stream (*this).

Hinweise

Die Eingabefunktion unformatierte extrahiert bis zu count-Elemente und speichert sie im Arrayanfang am _Str.Extraktion beendet früh Dateiende, in diesem Fall die Funktionsaufrufe setstate(failbit).In jedem Fall wird *this zurück.

Beispiel

// basic_istream_read.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;

int main()
{
    char c[10];
    int count = 5;

    cout << "Type 'abcde': ";

    // Note: cin::read is potentially unsafe, consider
    // using cin::_Read_s instead.
    cin.read(&c[0], count);
    c[count] = 0;

    cout << c << endl;
}
  abcde
  abcde
"Typ": abcde abcde abcde

Anforderungen

Header: <istream>

Namespace: std

Siehe auch

Referenz

basic_istream Class

Programmierung der iostream-Headerdatei

iostreams Konventionen