std::basic_istream::readsome

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++11) Atomic operations library (C++11) Thread support library (C++11)
Input/output library
basic_streambuf basic_filebuf basic_stringbuf ios_base basic_ios basic_istream basic_ostream basic_iostream basic_ifstream basic_ofstream basic_fstream basic_istringstream basic_ostringstream basic_stringstream I/O manipulators C-style I/O
std::basic_istream
Member functions basic_istream::basic_istream basic_istream::~basic_istream Formatted input basic_istream::operator>> Unformatted input basic_istream::get basic_istream::peek basic_istream::unget basic_istream::putback basic_istream::getline basic_istream::ignore basic_istream::read basic_istream::readsome basic_istream::gcount Positioning basic_istream::tellg basic_istream::seekg Miscellaneous basic_istream::sync Member classes basic_istream::sentry

basic_istream& readsome( char_type* s, streamsize count );

Extracts immediately available characters from the input stream.

If good() != true, setstate(failbit) is called and the function returns. At most count characters are extracted. If end-of-file is encountered earlier, setstate(eofbit is called and the function returns.

Function uses rdbuf()->in_avail() to determine how many characters are available for extraction. Note, that using this function with standard input does not guarantee that the function will not block.

Contents 1 Parameters 2 Return value 3 Example 4 See also

[edit] Parameters

s	-	pointer to the character string to store the characters to
count	-	maximum number of characters to read

[edit] Return value

*this

[edit] Example

This section is incomplete

[edit] See also

read	extracts blocks of characters (public member function)