cpp/named req/FormattedInputFunction - Revision history

Cesar: spanish link

2025-01-13T10:29:26Z

spanish link

← Older revision		Revision as of 10:29, 13 January 2025
Line 34:		Line 34:
	{{dr list end}}		{{dr list end}}

	{{langlinks\|ja\|zh}}		{{langlinks\|es\|ja\|zh}}

Andreas Krug: .

2023-10-08T15:10:06Z

← Older revision		Revision as of 15:10, 8 October 2023
Line 5:		Line 5:
	A {{named req/core\|FormattedInputFunction}} is a stream input function that performs the following:		A {{named req/core\|FormattedInputFunction}} is a stream input function that performs the following:

	* Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|false}}, which performs the following		* Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|false}}, which performs the following:
	:* if {{ltt\|cpp/io/ios_base/iostate\|eofbit}} or {{ltt\|cpp/io/ios_base/iostate\|badbit}} are set on the input stream, sets the {{tt\|failbit}} as well, and if exceptions on {{tt\|failbit}} are enabled in this input stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & failbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.		:* if {{ltt\|cpp/io/ios_base/iostate\|eofbit}} or {{ltt\|cpp/io/ios_base/iostate\|badbit}} are set on the input stream, sets the {{tt\|failbit}} as well, and if exceptions on {{tt\|failbit}} are enabled in this input stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & failbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.
	:* flushes the tie()'d output stream, if applicable		:* flushes the tie()'d output stream, if applicable.
	:* if {{tt\|ios_base::skipws}} flag is set on this input stream, extracts and discards characters from the input stream until one of the following becomes true:		:* if {{tt\|ios_base::skipws}} flag is set on this input stream, extracts and discards characters from the input stream until one of the following becomes true:
	::* the next available character on the input stream is not a whitespace character, as tested by the {{lc\|std::ctype}} facet of the locale currently imbued in this input stream. The non-whitespace character is not extracted.		::* the next available character on the input stream is not a whitespace character, as tested by the {{lc\|std::ctype}} facet of the locale currently imbued in this input stream. The non-whitespace character is not extracted.
	::* the end of the stream is reached, in which case {{tt\|failbit}} and {{tt\|eofbit}} are set and if the stream is on for exceptions on one of these bits, {{l2tt\|cpp/io/ios_base/failure}} is thrown.		::* the end of the stream is reached, in which case {{tt\|failbit}} and {{tt\|eofbit}} are set and if the stream is on for exceptions on one of these bits, {{l2tt\|cpp/io/ios_base/failure}} is thrown.
	* Checks the status of the sentry by calling {{tt\|sentry::operator bool()}}, which is equivalent to {{l2tt\|cpp/io/basic_ios/good}}.		* Checks the status of the sentry by calling {{tt\|sentry::operator bool()}}, which is equivalent to {{l2tt\|cpp/io/basic_ios/good}}.
	* If the sentry returned {{c\|false}} or sentry's constructor threw an exception, no input takes place		* If the sentry returned {{c\|false}} or sentry's constructor threw an exception, no input takes place.
	* If the sentry returned {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.		* If the sentry returned {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.
	:* if the end of the stream is reached (the call to {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}} returns {{c\|Traits::eof()}}), sets {{tt\|eofbit}}. If exceptions on {{tt\|eofbit}} are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & eofbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.		:* if the end of the stream is reached (the call to {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}} returns {{c\|Traits::eof()}}), sets {{tt\|eofbit}}. If exceptions on {{tt\|eofbit}} are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & eofbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.

Xmcgcg: {{tt}}

2022-09-20T01:58:19Z

← Older revision		Revision as of 01:58, 20 September 2022
Line 6:		Line 6:

	* Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|false}}, which performs the following		* Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|false}}, which performs the following
	:* if {{ltt\|cpp/io/ios_base/iostate\|eofbit}} or {{ltt\|cpp/io/ios_base/iostate\|badbit}} are set on the input stream, sets the {{tt\|failbit}} as well, and if exceptions on failbit are enabled in this input stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & failbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.		:* if {{ltt\|cpp/io/ios_base/iostate\|eofbit}} or {{ltt\|cpp/io/ios_base/iostate\|badbit}} are set on the input stream, sets the {{tt\|failbit}} as well, and if exceptions on {{tt\|failbit}} are enabled in this input stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & failbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.
	:* flushes the tie()'d output stream, if applicable		:* flushes the tie()'d output stream, if applicable
	:* if {{tt\|ios_base::skipws}} flag is set on this input stream, extracts and discards characters from the input stream until one of the following becomes true:		:* if {{tt\|ios_base::skipws}} flag is set on this input stream, extracts and discards characters from the input stream until one of the following becomes true:
Line 14:		Line 14:
	* If the sentry returned {{c\|false}} or sentry's constructor threw an exception, no input takes place		* If the sentry returned {{c\|false}} or sentry's constructor threw an exception, no input takes place
	* If the sentry returned {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.		* If the sentry returned {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.
	:* if the end of the stream is reached (the call to {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}} returns {{c\|Traits::eof()}}), sets {{tt\|eofbit}}. If exceptions on eofbit are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & eofbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.		:* if the end of the stream is reached (the call to {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}} returns {{c\|Traits::eof()}}), sets {{tt\|eofbit}}. If exceptions on {{tt\|eofbit}} are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & eofbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.
	:* if an exception is thrown during input, sets {{tt\|badbit}} in the input stream. If exceptions on badbit are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & badbit) != 0}}), the exception is also rethrown.		:* if an exception is thrown during input, sets {{tt\|badbit}} in the input stream. If exceptions on {{tt\|badbit}} are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & badbit) != 0}}), the exception is also rethrown.
	:* If no exception was thrown, returns {{c\|*this}}.		:* If no exception was thrown, returns {{c\|*this}}.
	* In any event, whether terminating by exception or returning, the sentry's destructor is called before leaving this function.		* In any event, whether terminating by exception or returning, the sentry's destructor is called before leaving this function.

Xmcgcg: Added LWG issue #160 DR (part 2).

2022-09-20T01:35:57Z

Added LWG issue #160 DR (part 2).

← Older revision		Revision as of 01:35, 20 September 2022
Line 3:		Line 3:

	===Requirements===		===Requirements===

	A {{named req/core\|FormattedInputFunction}} is a stream input function that performs the following:		A {{named req/core\|FormattedInputFunction}} is a stream input function that performs the following:

	* Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|false}}, which performs the following		* Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|false}}, which performs the following
	:* if {{ltt\|cpp/io/ios_base/iostate\|eofbit}} or {{ltt\|cpp/io/ios_base/iostate\|badbit}} are set on the input stream, sets the {{tt\|failbit}} as well, and if exceptions on failbit are enabled in this input stream's exception mask, throws {{l2tt\|cpp/io/ios_base/failure}}.		:* if {{ltt\|cpp/io/ios_base/iostate\|eofbit}} or {{ltt\|cpp/io/ios_base/iostate\|badbit}} are set on the input stream, sets the {{tt\|failbit}} as well, and if exceptions on failbit are enabled in this input stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & failbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.
	:* flushes the tie()'d output stream, if applicable		:* flushes the tie()'d output stream, if applicable
	:* if {{tt\|ios_base::skipws}} flag is set on this input stream, extracts and discards characters from the input stream until one of the following becomes true:		:* if {{tt\|ios_base::skipws}} flag is set on this input stream, extracts and discards characters from the input stream until one of the following becomes true:
Line 15:		Line 14:
	* If the sentry returned {{c\|false}} or sentry's constructor threw an exception, no input takes place		* If the sentry returned {{c\|false}} or sentry's constructor threw an exception, no input takes place
	* If the sentry returned {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.		* If the sentry returned {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.
	:* if the end of the stream is reached (the call to {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}} returns {{c\|Traits::eof()}}), sets {{tt\|eofbit}}. If exceptions on eofbit are enabled in this stream's exception mask, throws {{l2tt\|cpp/io/ios_base/failure}}.		:* if the end of the stream is reached (the call to {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}} returns {{c\|Traits::eof()}}), sets {{tt\|eofbit}}. If exceptions on eofbit are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & eofbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.
	:* if an exception is thrown during input, sets {{tt\|badbit}} in the input stream. If exceptions on badbit are enabled in this stream's exception mask, the exception is also rethrown.		:* if an exception is thrown during input, sets {{tt\|badbit}} in the input stream. If exceptions on badbit are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & badbit) != 0}}), the exception is also rethrown.
	:* If no exception was thrown, returns {{c\|*this}}.		:* If no exception was thrown, returns {{c\|*this}}.
	* In any event, whether terminating by exception or returning, the sentry's destructor is called before leaving this function.		* In any event, whether terminating by exception or returning, the sentry's destructor is called before leaving this function.

	===Standard library===		===Standard library===

	The following standard library functions are {{named req\|FormattedInputFunction}}s.		The following standard library functions are {{named req\|FormattedInputFunction}}s.

Line 30:		Line 28:
	* {{ltt\|cpp/string/basic_string/operator_ltltgtgt\|operator>>{{dsc small\|(std::basic_istream, std::string)}}}}		* {{ltt\|cpp/string/basic_string/operator_ltltgtgt\|operator>>{{dsc small\|(std::basic_istream, std::string)}}}}
	* {{tt\|operator>>}}, when called on the return value of {{lc\|std::get_money}}		* {{tt\|operator>>}}, when called on the return value of {{lc\|std::get_money}}

			===Defect reports===
			{{dr list begin}}
			{{dr list item\|wg=lwg\|dr=160\|std=C++98\|before=the process of determining whether the exception caught<br>is rethrown mentioned a non-existing function {{tt\|exception()}}\|after=corrected to {{ltt\|cpp/io/basic_ios/exceptions\|exceptions()}}}}
			{{dr list end}}

	{{langlinks\|ja\|zh}}		{{langlinks\|ja\|zh}}

Milkpot: link to ja

2018-07-06T13:57:39Z

link to ja

← Older revision		Revision as of 13:57, 6 July 2018
Line 31:		Line 31:
	* {{tt\|operator>>}}, when called on the return value of {{lc\|std::get_money}}		* {{tt\|operator>>}}, when called on the return value of {{lc\|std::get_money}}

	{{langlinks\|zh}}		{{langlinks\|ja\|zh}}

T. Canens: named req/core

2018-06-17T09:23:32Z

named req/core

← Older revision		Revision as of 09:23, 17 June 2018
Line 4:		Line 4:
	===Requirements===		===Requirements===

	A {{tt\|FormattedInputFunction}} is a stream input function that performs the following:		A {{named req/core\|FormattedInputFunction}} is a stream input function that performs the following:

	* Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|false}}, which performs the following		* Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|false}}, which performs the following

T. Canens: Text replace - "{{concept" to "{{named req"

2018-06-15T22:35:57Z

Text replace - "{{concept" to "{{named req"

← Older revision		Revision as of 22:35, 15 June 2018
Line 22:		Line 22:
	===Standard library===		===Standard library===

	The following standard library functions are {{~~concept~~\|FormattedInputFunction}}s.		The following standard library functions are {{named req\|FormattedInputFunction}}s.

	* {{l2tt\|cpp/io/basic_istream/operator_gtgt\|operator>>{{dsc small\|(int, long, double, void*, bool)}}}}		* {{l2tt\|cpp/io/basic_istream/operator_gtgt\|operator>>{{dsc small\|(int, long, double, void*, bool)}}}}

T. Canens: T. Canens moved page cpp/concept/FormattedInputFunction to cpp/named req/FormattedInputFunction without leaving a redirect: Text replace - "cpp/concept" to "cpp/named req"

2018-06-15T21:50:57Z

T. Canens moved page cpp/concept/FormattedInputFunction to cpp/named req/FormattedInputFunction without leaving a redirect: Text replace - "cpp/concept" to "cpp/named req"

← Older revision		Revision as of 21:50, 15 June 2018
(No difference)

T. Canens: Text replace - "cpp/concept" to "cpp/named req"

2018-06-15T21:40:01Z

Text replace - "cpp/concept" to "cpp/named req"

← Older revision		Revision as of 21:40, 15 June 2018
Line 1:		Line 1:
	{{cpp/~~concept~~/title\|FormattedInputFunction}}		{{cpp/named req/title\|FormattedInputFunction}}
	{{cpp/~~concept~~/navbar}}		{{cpp/named req/navbar}}

	===Requirements===		===Requirements===

Fruderica: link to zh

2017-08-21T17:18:50Z

link to zh

← Older revision		Revision as of 17:18, 21 August 2017
Line 30:		Line 30:
	* {{ltt\|cpp/string/basic_string/operator_ltltgtgt\|operator>>{{dsc small\|(std::basic_istream, std::string)}}}}		* {{ltt\|cpp/string/basic_string/operator_ltltgtgt\|operator>>{{dsc small\|(std::basic_istream, std::string)}}}}
	* {{tt\|operator>>}}, when called on the return value of {{lc\|std::get_money}}		* {{tt\|operator>>}}, when called on the return value of {{lc\|std::get_money}}

			{{langlinks\|zh}}

← Older revision		Revision as of 15:10, 8 October 2023
Line 5:		Line 5:
	A {{named req/core\|FormattedInputFunction}} is a stream input function that performs the following:		A {{named req/core\|FormattedInputFunction}} is a stream input function that performs the following:

	* Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|false}}, which performs the following		* Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|false}}, which performs the following:
	:* if {{ltt\|cpp/io/ios_base/iostate\|eofbit}} or {{ltt\|cpp/io/ios_base/iostate\|badbit}} are set on the input stream, sets the {{tt\|failbit}} as well, and if exceptions on {{tt\|failbit}} are enabled in this input stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & failbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.		:* if {{ltt\|cpp/io/ios_base/iostate\|eofbit}} or {{ltt\|cpp/io/ios_base/iostate\|badbit}} are set on the input stream, sets the {{tt\|failbit}} as well, and if exceptions on {{tt\|failbit}} are enabled in this input stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & failbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.
	:* flushes the tie()'d output stream, if applicable		:* flushes the tie()'d output stream, if applicable.
	:* if {{tt\|ios_base::skipws}} flag is set on this input stream, extracts and discards characters from the input stream until one of the following becomes true:		:* if {{tt\|ios_base::skipws}} flag is set on this input stream, extracts and discards characters from the input stream until one of the following becomes true:
	::* the next available character on the input stream is not a whitespace character, as tested by the {{lc\|std::ctype}} facet of the locale currently imbued in this input stream. The non-whitespace character is not extracted.		::* the next available character on the input stream is not a whitespace character, as tested by the {{lc\|std::ctype}} facet of the locale currently imbued in this input stream. The non-whitespace character is not extracted.
	::* the end of the stream is reached, in which case {{tt\|failbit}} and {{tt\|eofbit}} are set and if the stream is on for exceptions on one of these bits, {{l2tt\|cpp/io/ios_base/failure}} is thrown.		::* the end of the stream is reached, in which case {{tt\|failbit}} and {{tt\|eofbit}} are set and if the stream is on for exceptions on one of these bits, {{l2tt\|cpp/io/ios_base/failure}} is thrown.
	* Checks the status of the sentry by calling {{tt\|sentry::operator bool()}}, which is equivalent to {{l2tt\|cpp/io/basic_ios/good}}.		* Checks the status of the sentry by calling {{tt\|sentry::operator bool()}}, which is equivalent to {{l2tt\|cpp/io/basic_ios/good}}.
	* If the sentry returned {{c\|false}} or sentry's constructor threw an exception, no input takes place		* If the sentry returned {{c\|false}} or sentry's constructor threw an exception, no input takes place.
	* If the sentry returned {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.		* If the sentry returned {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.
	:* if the end of the stream is reached (the call to {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}} returns {{c\|Traits::eof()}}), sets {{tt\|eofbit}}. If exceptions on {{tt\|eofbit}} are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & eofbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.		:* if the end of the stream is reached (the call to {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}} returns {{c\|Traits::eof()}}), sets {{tt\|eofbit}}. If exceptions on {{tt\|eofbit}} are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & eofbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.

← Older revision		Revision as of 01:58, 20 September 2022
Line 6:		Line 6:

	* Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|false}}, which performs the following		* Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|false}}, which performs the following
	:* if {{ltt\|cpp/io/ios_base/iostate\|eofbit}} or {{ltt\|cpp/io/ios_base/iostate\|badbit}} are set on the input stream, sets the {{tt\|failbit}} as well, and if exceptions on failbit are enabled in this input stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & failbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.		:* if {{ltt\|cpp/io/ios_base/iostate\|eofbit}} or {{ltt\|cpp/io/ios_base/iostate\|badbit}} are set on the input stream, sets the {{tt\|failbit}} as well, and if exceptions on {{tt\|failbit}} are enabled in this input stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & failbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.
	:* flushes the tie()'d output stream, if applicable		:* flushes the tie()'d output stream, if applicable
	:* if {{tt\|ios_base::skipws}} flag is set on this input stream, extracts and discards characters from the input stream until one of the following becomes true:		:* if {{tt\|ios_base::skipws}} flag is set on this input stream, extracts and discards characters from the input stream until one of the following becomes true:
Line 14:		Line 14:
	* If the sentry returned {{c\|false}} or sentry's constructor threw an exception, no input takes place		* If the sentry returned {{c\|false}} or sentry's constructor threw an exception, no input takes place
	* If the sentry returned {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.		* If the sentry returned {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.
	:* if the end of the stream is reached (the call to {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}} returns {{c\|Traits::eof()}}), sets {{tt\|eofbit}}. If exceptions on eofbit are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & eofbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.		:* if the end of the stream is reached (the call to {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}} returns {{c\|Traits::eof()}}), sets {{tt\|eofbit}}. If exceptions on {{tt\|eofbit}} are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & eofbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.
	:* if an exception is thrown during input, sets {{tt\|badbit}} in the input stream. If exceptions on badbit are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & badbit) != 0}}), the exception is also rethrown.		:* if an exception is thrown during input, sets {{tt\|badbit}} in the input stream. If exceptions on {{tt\|badbit}} are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & badbit) != 0}}), the exception is also rethrown.
	:* If no exception was thrown, returns {{c\|*this}}.		:* If no exception was thrown, returns {{c\|*this}}.
	* In any event, whether terminating by exception or returning, the sentry's destructor is called before leaving this function.		* In any event, whether terminating by exception or returning, the sentry's destructor is called before leaving this function.

← Older revision		Revision as of 01:35, 20 September 2022
Line 3:		Line 3:

	===Requirements===		===Requirements===

	A {{named req/core\|FormattedInputFunction}} is a stream input function that performs the following:		A {{named req/core\|FormattedInputFunction}} is a stream input function that performs the following:

	* Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|false}}, which performs the following		* Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|false}}, which performs the following
	:* if {{ltt\|cpp/io/ios_base/iostate\|eofbit}} or {{ltt\|cpp/io/ios_base/iostate\|badbit}} are set on the input stream, sets the {{tt\|failbit}} as well, and if exceptions on failbit are enabled in this input stream's exception mask, throws {{l2tt\|cpp/io/ios_base/failure}}.		:* if {{ltt\|cpp/io/ios_base/iostate\|eofbit}} or {{ltt\|cpp/io/ios_base/iostate\|badbit}} are set on the input stream, sets the {{tt\|failbit}} as well, and if exceptions on failbit are enabled in this input stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & failbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.
	:* flushes the tie()'d output stream, if applicable		:* flushes the tie()'d output stream, if applicable
	:* if {{tt\|ios_base::skipws}} flag is set on this input stream, extracts and discards characters from the input stream until one of the following becomes true:		:* if {{tt\|ios_base::skipws}} flag is set on this input stream, extracts and discards characters from the input stream until one of the following becomes true:
Line 15:		Line 14:
	* If the sentry returned {{c\|false}} or sentry's constructor threw an exception, no input takes place		* If the sentry returned {{c\|false}} or sentry's constructor threw an exception, no input takes place
	* If the sentry returned {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.		* If the sentry returned {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.
	:* if the end of the stream is reached (the call to {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}} returns {{c\|Traits::eof()}}), sets {{tt\|eofbit}}. If exceptions on eofbit are enabled in this stream's exception mask, throws {{l2tt\|cpp/io/ios_base/failure}}.		:* if the end of the stream is reached (the call to {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}} returns {{c\|Traits::eof()}}), sets {{tt\|eofbit}}. If exceptions on eofbit are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & eofbit) != 0}}), throws {{l2tt\|cpp/io/ios_base/failure}}.
	:* if an exception is thrown during input, sets {{tt\|badbit}} in the input stream. If exceptions on badbit are enabled in this stream's exception mask, the exception is also rethrown.		:* if an exception is thrown during input, sets {{tt\|badbit}} in the input stream. If exceptions on badbit are enabled in this stream's [[cpp/io/basic_ios/exceptions\|exception mask]] ({{c\|1=(exceptions() & badbit) != 0}}), the exception is also rethrown.
	:* If no exception was thrown, returns {{c\|*this}}.		:* If no exception was thrown, returns {{c\|*this}}.
	* In any event, whether terminating by exception or returning, the sentry's destructor is called before leaving this function.		* In any event, whether terminating by exception or returning, the sentry's destructor is called before leaving this function.

	===Standard library===		===Standard library===

	The following standard library functions are {{named req\|FormattedInputFunction}}s.		The following standard library functions are {{named req\|FormattedInputFunction}}s.

Line 30:		Line 28:
	* {{ltt\|cpp/string/basic_string/operator_ltltgtgt\|operator>>{{dsc small\|(std::basic_istream, std::string)}}}}		* {{ltt\|cpp/string/basic_string/operator_ltltgtgt\|operator>>{{dsc small\|(std::basic_istream, std::string)}}}}
	* {{tt\|operator>>}}, when called on the return value of {{lc\|std::get_money}}		* {{tt\|operator>>}}, when called on the return value of {{lc\|std::get_money}}

			===Defect reports===
			{{dr list begin}}
			{{dr list item\|wg=lwg\|dr=160\|std=C++98\|before=the process of determining whether the exception caught<br>is rethrown mentioned a non-existing function {{tt\|exception()}}\|after=corrected to {{ltt\|cpp/io/basic_ios/exceptions\|exceptions()}}}}
			{{dr list end}}

	{{langlinks\|ja\|zh}}		{{langlinks\|ja\|zh}}

← Older revision		Revision as of 17:18, 21 August 2017
Line 30:		Line 30:
	* {{ltt\|cpp/string/basic_string/operator_ltltgtgt\|operator>>{{dsc small\|(std::basic_istream, std::string)}}}}		* {{ltt\|cpp/string/basic_string/operator_ltltgtgt\|operator>>{{dsc small\|(std::basic_istream, std::string)}}}}
	* {{tt\|operator>>}}, when called on the return value of {{lc\|std::get_money}}		* {{tt\|operator>>}}, when called on the return value of {{lc\|std::get_money}}

			{{langlinks\|zh}}