Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer


Reads a specified number of characters from the stream and stores them in an array.

basic_istream& _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;



Sample Output

Type 'abcde': abcde

Header: <istream>

© 2016 Microsoft