cpp/named req/UnformattedInputFunction - Revision history

Xmcgcg: Added LWG issue #243 DR.

2022-10-18T07:21:58Z

Added LWG issue #243 DR.

← Older revision		Revision as of 07:21, 18 October 2022
Line 41:		Line 41:
	{{dr list item\|wg=lwg\|dr=61\|std=C++98\|before=it was unclear whether throwing an exception because of<br>setting {{tt\|eofbit}} and/or {{tt\|failbit}} will result in setting {{tt\|badbit}}\|after=exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}}<br>are not caught or rethrown}}		{{dr list item\|wg=lwg\|dr=61\|std=C++98\|before=it was unclear whether throwing an exception because of<br>setting {{tt\|eofbit}} and/or {{tt\|failbit}} will result in setting {{tt\|badbit}}\|after=exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}}<br>are not caught or rethrown}}
	{{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 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 item\|wg=lwg\|dr=243\|std=C++98\|before=the behavior when {{tt\|sentry::operator bool()}} returns {{c\|false}}<br>or the sentry object fails to be constructed was not specified\|after=specified}}
	{{dr list end}}		{{dr list end}}

	{{langlinks\|de\|es\|fr\|it\|ja\|pt\|ru\|zh}}		{{langlinks\|de\|es\|fr\|it\|ja\|pt\|ru\|zh}}

Xmcgcg: Added a missing exception mask link.

2022-09-20T01:33:37Z

Added a missing exception mask link.

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

	@1@ Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|true}}, which performs the following:		@1@ Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|true}}, 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 {{ltt\|cpp/io/ios_base/iostate\|failbit}} as well, and if exceptions on {{tt\|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 {{ltt\|cpp/io/ios_base/iostate\|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.
	@2@ Checks the status of the sentry by calling {{tt\|sentry::operator bool()}}, which is equivalent to {{l2tt\|cpp/io/basic_ios/good}}.		@2@ Checks the status of the sentry by calling {{tt\|sentry::operator bool()}}, which is equivalent to {{l2tt\|cpp/io/basic_ios/good}}.

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

2022-09-20T01:28:01Z

Added LWG issue #160 DR (part 1).

← Older revision		Revision as of 01:28, 20 September 2022
Line 13:		Line 13:
	:* If the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array.		:* If the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array.
	* If the operator returns {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.		* If the operator returns {{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 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 {{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 {{tt\|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 {{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.
	::* Exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}} are not caught or rethrown.		::* Exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}} are not caught or rethrown.
	:* If no exception was thrown during input, sets the number of extracted characters (gcount) in the input stream.		:* If no exception was thrown during input, sets the number of extracted characters (gcount) in the input stream.
Line 40:		Line 40:
	{{dr list begin}}		{{dr list begin}}
	{{dr list item\|wg=lwg\|dr=61\|std=C++98\|before=it was unclear whether throwing an exception because of<br>setting {{tt\|eofbit}} and/or {{tt\|failbit}} will result in setting {{tt\|badbit}}\|after=exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}}<br>are not caught or rethrown}}		{{dr list item\|wg=lwg\|dr=61\|std=C++98\|before=it was unclear whether throwing an exception because of<br>setting {{tt\|eofbit}} and/or {{tt\|failbit}} will result in setting {{tt\|badbit}}\|after=exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}}<br>are not caught or rethrown}}
			{{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}}		{{dr list end}}

	{{langlinks\|de\|es\|fr\|it\|ja\|pt\|ru\|zh}}		{{langlinks\|de\|es\|fr\|it\|ja\|pt\|ru\|zh}}

Xmcgcg: Minor fix (sentry returns -> operator returns).

2022-08-16T06:02:35Z

Minor fix (sentry returns -> operator returns).

← Older revision		Revision as of 06:02, 16 August 2022
Line 9:		Line 9:
	* Flushes the tie()'d output stream, if applicable.		* Flushes the tie()'d output stream, if applicable.
	@2@ Checks the status of the sentry by calling {{tt\|sentry::operator bool()}}, which is equivalent to {{l2tt\|cpp/io/basic_ios/good}}.		@2@ 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~~ returns {{c\|false}} or sentry's constructor throws an exception:		* If the operator returns {{c\|false}} or sentry's constructor throws an exception:
	:* Sets the number of extracted characters (gcount) in the input stream to zero.		:* Sets the number of extracted characters (gcount) in the input stream to zero.
	:* If the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array.		:* If the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array.
	* If the ~~sentry~~ returns {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.		* If the operator returns {{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 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 {{tt\|eofbit}} are enabled in this stream's exception mask, throws {{l2tt\|cpp/io/ios_base/failure}}.
	:* 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 exception mask, 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 exception mask, the exception is also rethrown.

Xmcgcg: Minor tweak.

2022-08-16T06:00:33Z

Minor tweak.

← Older revision		Revision as of 06:00, 16 August 2022
Line 6:		Line 6:

	@1@ Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|true}}, which performs the following:		@1@ Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|true}}, 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 {{ltt\|cpp/io/ios_base/iostate\|failbit}} as well, and if exceptions on {{tt\|failbit}} are enabled in this input stream's exception mask, throws {{l2tt\|cpp/io/ios_base/failure}}.
	* Flushes the tie()'d output stream, if applicable.		* Flushes the tie()'d output stream, if applicable.
	@2@ Checks the status of the sentry by calling {{tt\|sentry::operator bool()}}, which is equivalent to {{l2tt\|cpp/io/basic_ios/good}}.		@2@ Checks the status of the sentry by calling {{tt\|sentry::operator bool()}}, which is equivalent to {{l2tt\|cpp/io/basic_ios/good}}.
Line 13:		Line 13:
	:* If the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array.		:* If the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array.
	* If the sentry returns {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.		* If the sentry returns {{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 {{tt\|eofbit}} are enabled in this stream's exception mask, 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 {{tt\|badbit}} are enabled in this stream's exception mask, the exception is also rethrown.
	::* Exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}} are not caught or rethrown.		::* Exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}} are not caught or rethrown.
	:* If no exception was thrown during input, sets the number of extracted characters (gcount) in the input stream.		:* If no exception was thrown during input, sets the number of extracted characters (gcount) in the input stream.

Xmcgcg: Added LWG issue #61 DR.

2022-08-16T03:54:32Z

Added LWG issue #61 DR.

← Older revision		Revision as of 03:54, 16 August 2022
Line 3:		Line 3:

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

	An {{named req/core\|UnformattedInputFunction}} is a stream input function that performs the following:		An {{named req/core\|UnformattedInputFunction}} 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\|true}}, which performs the following		@1@ Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|true}}, 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 exception mask, throws {{l2tt\|cpp/io/ios_base/failure}}.
	:* ~~flushes~~ the tie()'d output stream, if applicable		* Flushes the tie()'d output stream, if applicable.
	* Checks the status of the sentry by calling {{tt\|sentry::operator bool()}}, which is equivalent to {{l2tt\|cpp/io/basic_ios/good}}.		@2@ 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:		* If the sentry returns {{c\|false}} or sentry's constructor throws an exception:
	:* ~~sets~~ the number of extracted characters (gcount) in the input stream to zero		:* Sets the number of extracted characters (gcount) in the input stream to zero.
	:* if the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array		:* If the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array.
	* If the sentry ~~returned~~ {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.		* If the sentry returns {{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 exception mask, 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 exception mask, the exception is also rethrown.
			::* Exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}} are not caught or rethrown.
	:* If no exception was thrown during input, sets the number of extracted characters (gcount) in the input stream.		:* If no exception was thrown during input, sets the number of extracted characters (gcount) in the input stream.
	* In any event, whether terminating by exception or returning, the sentry's destructor is called before leaving this function.		@3@ 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\|UnformattedInputFunction}}s.		The following standard library functions are {{named req\|UnformattedInputFunction}}s.

Line 38:		Line 37:
	* {{lc\|std::ws}}, except that it does not modify gcount		* {{lc\|std::ws}}, except that it does not modify gcount

	~~[[de:~~cpp/~~named req~~/~~UnformattedInputFunction]]~~		===Defect reports===
	[[es~~:cpp/named req/UnformattedInputFunction]]~~		{{dr list begin}}
	[[fr~~:cpp/named req/UnformattedInputFunction]]~~		{{dr list item\|wg=lwg\|dr=61\|std=C++98\|before=it was unclear whether throwing an exception because of<br>setting {{tt\|eofbit}} and/or {{tt\|failbit}} will result in setting {{tt\|badbit}}\|after=exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}}<br>are not caught or rethrown}}
	[[it~~:cpp/named req/UnformattedInputFunction]]~~		{{dr list end}}
	[[ja~~:cpp/named req/UnformattedInputFunction]]~~
	[[pt~~:cpp/named req/UnformattedInputFunction]]~~		{{langlinks\|de\|es\|fr\|it\|ja\|pt\|ru\|zh}}
	[[ru~~:cpp/named req/UnformattedInputFunction]]~~
	[[zh~~:cpp/named req/UnformattedInputFunction]]~~

139.181.7.34: Added missing close parenthesis in bullet for end of the stream

2019-12-23T22:58:52Z

Added missing close parenthesis in bullet for end of the stream

← Older revision		Revision as of 22:58, 23 December 2019
Line 14:		Line 14:
	:* if the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array		:* if the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array
	* 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 exception mask, 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 exception mask, the exception is also rethrown.
	:* If no exception was thrown during input, sets the number of extracted characters (gcount) in the input stream.		:* If no exception was thrown during input, sets the number of extracted characters (gcount) in the input stream.

T. Canens: named req/core

2018-06-17T09:23:50Z

named req/core

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

	An {{tt\|UnformattedInputFunction}} is a stream input function that performs the following:		An {{named req/core\|UnformattedInputFunction}} 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\|true}}, 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\|true}}, which performs the following

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

2018-06-15T22:13:01Z

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

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

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

	* {{lc\|std::getline}}, except that it does not modify gcount.		* {{lc\|std::getline}}, except that it does not modify gcount.

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

2018-06-15T21:57:39Z

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

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

	===Requirements===		===Requirements===
Line 38:		Line 38:
	* {{lc\|std::ws}}, except that it does not modify gcount		* {{lc\|std::ws}}, except that it does not modify gcount

	[[de:cpp/~~concept~~/UnformattedInputFunction]]		[[de:cpp/named req/UnformattedInputFunction]]
	[[es:cpp/~~concept~~/UnformattedInputFunction]]		[[es:cpp/named req/UnformattedInputFunction]]
	[[fr:cpp/~~concept~~/UnformattedInputFunction]]		[[fr:cpp/named req/UnformattedInputFunction]]
	[[it:cpp/~~concept~~/UnformattedInputFunction]]		[[it:cpp/named req/UnformattedInputFunction]]
	[[ja:cpp/~~concept~~/UnformattedInputFunction]]		[[ja:cpp/named req/UnformattedInputFunction]]
	[[pt:cpp/~~concept~~/UnformattedInputFunction]]		[[pt:cpp/named req/UnformattedInputFunction]]
	[[ru:cpp/~~concept~~/UnformattedInputFunction]]		[[ru:cpp/named req/UnformattedInputFunction]]
	[[zh:cpp/~~concept~~/UnformattedInputFunction]]		[[zh:cpp/named req/UnformattedInputFunction]]

← Older revision		Revision as of 07:21, 18 October 2022
Line 41:		Line 41:
	{{dr list item\|wg=lwg\|dr=61\|std=C++98\|before=it was unclear whether throwing an exception because of<br>setting {{tt\|eofbit}} and/or {{tt\|failbit}} will result in setting {{tt\|badbit}}\|after=exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}}<br>are not caught or rethrown}}		{{dr list item\|wg=lwg\|dr=61\|std=C++98\|before=it was unclear whether throwing an exception because of<br>setting {{tt\|eofbit}} and/or {{tt\|failbit}} will result in setting {{tt\|badbit}}\|after=exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}}<br>are not caught or rethrown}}
	{{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 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 item\|wg=lwg\|dr=243\|std=C++98\|before=the behavior when {{tt\|sentry::operator bool()}} returns {{c\|false}}<br>or the sentry object fails to be constructed was not specified\|after=specified}}
	{{dr list end}}		{{dr list end}}

	{{langlinks\|de\|es\|fr\|it\|ja\|pt\|ru\|zh}}		{{langlinks\|de\|es\|fr\|it\|ja\|pt\|ru\|zh}}

← Older revision		Revision as of 01:28, 20 September 2022
Line 13:		Line 13:
	:* If the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array.		:* If the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array.
	* If the operator returns {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.		* If the operator returns {{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 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 {{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 {{tt\|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 {{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.
	::* Exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}} are not caught or rethrown.		::* Exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}} are not caught or rethrown.
	:* If no exception was thrown during input, sets the number of extracted characters (gcount) in the input stream.		:* If no exception was thrown during input, sets the number of extracted characters (gcount) in the input stream.
Line 40:		Line 40:
	{{dr list begin}}		{{dr list begin}}
	{{dr list item\|wg=lwg\|dr=61\|std=C++98\|before=it was unclear whether throwing an exception because of<br>setting {{tt\|eofbit}} and/or {{tt\|failbit}} will result in setting {{tt\|badbit}}\|after=exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}}<br>are not caught or rethrown}}		{{dr list item\|wg=lwg\|dr=61\|std=C++98\|before=it was unclear whether throwing an exception because of<br>setting {{tt\|eofbit}} and/or {{tt\|failbit}} will result in setting {{tt\|badbit}}\|after=exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}}<br>are not caught or rethrown}}
			{{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}}		{{dr list end}}

	{{langlinks\|de\|es\|fr\|it\|ja\|pt\|ru\|zh}}		{{langlinks\|de\|es\|fr\|it\|ja\|pt\|ru\|zh}}

← Older revision		Revision as of 06:02, 16 August 2022
Line 9:		Line 9:
	* Flushes the tie()'d output stream, if applicable.		* Flushes the tie()'d output stream, if applicable.
	@2@ Checks the status of the sentry by calling {{tt\|sentry::operator bool()}}, which is equivalent to {{l2tt\|cpp/io/basic_ios/good}}.		@2@ 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~~ returns {{c\|false}} or sentry's constructor throws an exception:		* If the operator returns {{c\|false}} or sentry's constructor throws an exception:
	:* Sets the number of extracted characters (gcount) in the input stream to zero.		:* Sets the number of extracted characters (gcount) in the input stream to zero.
	:* If the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array.		:* If the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array.
	* If the ~~sentry~~ returns {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.		* If the operator returns {{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 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 {{tt\|eofbit}} are enabled in this stream's exception mask, throws {{l2tt\|cpp/io/ios_base/failure}}.
	:* 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 exception mask, 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 exception mask, the exception is also rethrown.

← Older revision		Revision as of 06:00, 16 August 2022
Line 6:		Line 6:

	@1@ Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|true}}, which performs the following:		@1@ Constructs an object of type {{l2tt\|cpp/io/basic_istream/sentry}} with automatic storage duration and with the {{tt\|noskipws}} argument set to {{c\|true}}, 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 {{ltt\|cpp/io/ios_base/iostate\|failbit}} as well, and if exceptions on {{tt\|failbit}} are enabled in this input stream's exception mask, throws {{l2tt\|cpp/io/ios_base/failure}}.
	* Flushes the tie()'d output stream, if applicable.		* Flushes the tie()'d output stream, if applicable.
	@2@ Checks the status of the sentry by calling {{tt\|sentry::operator bool()}}, which is equivalent to {{l2tt\|cpp/io/basic_ios/good}}.		@2@ Checks the status of the sentry by calling {{tt\|sentry::operator bool()}}, which is equivalent to {{l2tt\|cpp/io/basic_ios/good}}.
Line 13:		Line 13:
	:* If the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array.		:* If the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array.
	* If the sentry returns {{c\|true}}, performs the input as if by calling {{c\|rdbuf()->sbumpc()}} or {{c\|rdbuf()->sgetc()}}.		* If the sentry returns {{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 {{tt\|eofbit}} are enabled in this stream's exception mask, 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 {{tt\|badbit}} are enabled in this stream's exception mask, the exception is also rethrown.
	::* Exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}} are not caught or rethrown.		::* Exceptions thrown from {{l2tt\|cpp/io/basic_ios/clear}} are not caught or rethrown.
	:* If no exception was thrown during input, sets the number of extracted characters (gcount) in the input stream.		:* If no exception was thrown during input, sets the number of extracted characters (gcount) in the input stream.

← Older revision		Revision as of 22:58, 23 December 2019
Line 14:		Line 14:
	:* if the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array		:* if the function was called to write to an array of {{tt\|CharT}}, writes {{tt\|CharT()}} (the null character) to the first location of the array
	* 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 exception mask, 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 exception mask, the exception is also rethrown.
	:* If no exception was thrown during input, sets the number of extracted characters (gcount) in the input stream.		:* If no exception was thrown during input, sets the number of extracted characters (gcount) in the input stream.