An UnformattedInputFunction is a stream input function that performs the following:
basic_istream::sentry
with automatic storage duration and with the noskipws
argument set to true
, which performs the following eofbit
or badbit
are set on the input stream, sets the failbit
as well, and if exceptions on failbit are enabled in this input stream's exception mask, throws ios_base::failure
. sentry::operator bool()
, which is equivalent to basic_ios::good
. false
or sentry's constructor threw an exception: CharT
, writes CharT()
(the null character) to the first location of the array true
, performs the input as if by calling rdbuf()->sbumpc()
or rdbuf()->sgetc()
. rdbuf()->sbumpc()
or rdbuf()->sgetc()
returns Traits::eof()
, sets eofbit
. If exceptions on eofbit are enabled in this stream's exception mask, throws ios_base::failure
. badbit
in the input stream. If exceptions on badbit are enabled in this stream's exception mask, the exception is also rethrown. The following standard library functions are UnformattedInputFunctions.
std::getline
, except that it does not modify gcount. basic_istream::operator>>(basic_streambuf*)
basic_istream::get
basic_istream::getline
basic_istream::ignore
basic_istream::peek
basic_istream::read
basic_istream::readsome
basic_istream::putback
, except that it first clears eofbit
basic_istream::unget
, except that it first clears eofbit
basic_istream::sync
, except that it does not modify gcount basic_istream::tellg
, except that it does not modify gcount basic_istream::seekg
, except that it first clears eofbit
and does not modify gcount std::ws
, except that it does not modify gcount
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
http://en.cppreference.com/w/cpp/named_req/UnformattedInputFunction