We recommend using Visual Studio 2017
This documentation is archived and is not being maintained.


Visual Studio 2008

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


The array in which to read the characters.


The size of _Str.


The number of characters to read.

The stream (*this).

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.

// 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

Header: <istream>

Namespace: std