basic_istream::_Read_s
Reads a specified number of characters from the stream and stores them in an array.
basic_istream<Elem, Tr>& _Read_s(
char_type *_Str,
size_t _Str_size,
streamsize _Count
);
Parameters
_Str
The array in which to read the characters._Str_size
The size of _Str._Count
The number of characters to read.
Return Value
The stream (*this).
Remarks
The unformatted input function extracts up to count elements and stores them in the array beginning at _Str. Extraction stops early on end of file, in which case the function calls setstate(failbit). In any case, it returns *this.
Example
// basic_istream__Read_s.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;
int main()
{
const int c_size = 10;
char c[c_size];
int count = 5;
cout << "Type 'abcde': ";
cin._Read_s(&c[0], c_size, count);
c[count] = 0;
cout << c << endl;
}
abcdeabcdeType 'abcde': abcde abcde
Requirements
Header: <istream>
Namespace: std
See Also
Reference
Safe Libraries: Standard C++ Library